Recorta superficies en los bordes o a lo largo de una curva cerrada.
Sintaxis
Clip2D(Surface, CuttingEdge, Mode)
La sintaxis de la función Clip2D consta de los siguientes elementos:
Parte |
Descripción |
||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Surface |
La superficie que se va a recortar, que puede estar disponible como matriz de datos/serie de señales o como curva espacial. Si especifica una serie de datos o una matriz de datos, el componente X y el componente Z se generan automáticamente. Las estructuras de datos permitidas son Matriz de datos, Serie de señales y Curva espacial. Se permiten todos los tipos de datos numéricos. Si el argumento es una lista, la función se ejecuta para cada elemento de la lista y el resultado también es una lista. |
||||||||||||||
CuttingEdge |
Especifica el borde de corte a lo largo del cual se realizará el corte. Las estructuras de datos permitidas son Valor escalar y Señal. Se permiten todos los tipos de datos numéricos. Si el argumento es una lista, se toma su primer elemento. Si se trata de nuevo de una lista, se repite el proceso. |
||||||||||||||
Mode |
Especifica el modo en que debe recortarse el conjunto de datos. El argumento Mode puede tener los siguientes valores:
Si el argumento es una lista, se toma su primer elemento. Si se trata de nuevo de una lista, se repite el proceso. |
Notas
Si Surface es del tipo de datos tiempo de calendario o duración, esto también se aplica al resultado. Para todos los demás tipos de datos de Surface, el tipo de datos del resultado es un número en coma flotante de 64 bits.
Si el argumento CuttingEdge se especifica como un valor escalar, se establecen como inválidos todos los valores Y cuyos valores X sean mayores (CLIP2D_XMAX), menores (CLIP2D_XMIN) o cuyos valores Z sean mayores (CLIP2D_ZMAX) o menores (CLIP2D_ZMIN) que el valor límite especificado.
Si el argumento CuttingEdge se especifica como una señal, el componente Y corresponde a la dimensión de la superficie que se va a recortar y el componente X, a la otra dimensión. Si es necesario, se realiza una interpolación. Si Mode es igual que CLIP2D_XMAX o CLIP2D_XMIN, el componente Y de la señal corresponde, por ejemplo, al componente X de la superficie y el componente X de la señal corresponde al componente Y de la superficie.
Para los modos CLIP2D_CURVEOUTSIDE y CLIP2D_CURVEINSIDE, el argumento CuttingEdge debe especificarse como señal. Los valores Y y X de la señal deben formar una curva cerrada a lo largo de la cual se realizará el corte. Los valores Y de la señal se asignan al componente Z de la superficie y los valores X, a su componente X. La curva especificada por la señal se cierra automáticamente, es decir, el primer punto de la señal no debe coincidir con el último.
Constante |
Procedimiento |
|---|---|
CLIP2D_XMAX |
Se invalidan todos los valores Y cuyo valor X asignado esté por encima del borde de corte especificado. |
CLIP2D_XMIN |
Se invalidan todos los valores Y cuyo valor X asignado esté por debajo del borde de corte especificado. |
CLIP2D_ZMAX |
Se invalidan todos los valores Y cuyo valor Z asignado esté por encima del borde de corte especificado. |
CLIP2D_ZMIN |
Se invalidan todos los valores Y cuyo valor Z asignado esté por debajo del borde de corte especificado. |
CLIP2D_CURVEOUTSIDE |
Todos los valores Y cuyas coordenadas X y Z asignadas se encuentren fuera de la curva cerrada y pasada como argumento CuttingEdge se establecen como inválidos. |
CLIP2D_CURVEINSIDE |
Todos los valores Y cuyas coordenadas X y Z asignadas se encuentren dentro de la curva cerrada y pasada como argumento CuttingEdge se establecen como inválidos. |
En los tipos de datos complejos se calcula un valor absoluto.
Disponibilidad
FlexPro Basic, Professional, Developer Suite
Ejemplos
Dim d = Data
d = Clip2D(d, 2000, CLIP2D_XMIN)
d = Clip2D(d, 10000, CLIP2D_XMAX)
d = Clip2D(d, 50, CLIP2D_ZMIN)
d = Clip2D(d, Signal({200,50},{2000,10000}), CLIP2D_ZMAX)
En el siguiente ejemplo, se recorta una superficie tanto en la dirección X como en la dirección Z.
Clip2D(Data, Signal({100,200,250,200,100,50},{2000,2000,6000,10000,10000,6000}), CLIP2D_CURVEINSIDE)
Clip2D(Data, Signal({100,200,250,200,100,50},{2000,2000,6000,10000,10000,6000}), CLIP2D_CURVEOUTSIDE)
El siguiente ejemplo muestra cómo se recorta un contorno con una curva cerrada.
