Placement/es: Difference between revisions

From FreeCAD Documentation
(Updating to match new version of source page)
 
(129 intermediate revisions by 5 users not shown)
Line 1: Line 1:
<languages/>

==Overview==

<div class="mw-translate-fuzzy">
==Introducción==
==Introducción==
'''Placement o Ubicación''' es el modo en que Freecad especifica la localización y la inclinación (orientación) de un objeto en el espacio. Placement puede ser especificado de múltiples formas y manipulado a través de [[Python_scripting_tutorial/es#Vectors_and_placements|Código]], del [[Property_editor/es|Editor de propiedades]] o seleccionando desde el menú {{MenuCommand|Editar → Ubicación...}} para abrir el [[Std_Placement|Panel de tareas de Ubicación]].
===Accediendo a los atributos de Placement===
Se puede acceder y modificar los atributos de Ubicación de un objeto de 3 maneras:
</div>


===Accessing the Placement Attribute===
'''nota de traducción:''' en esta página pretendemos mantener la siguiente correspondencia entre términos ingles-español


An object's Placement attributes can be accessed and modified in 3 ways:
placement emplazamiento


[[Image:PlacementPropertiesv10-800x800.png|frame|left|Placement o Ubicación en el panel de propiedades]]
attitude orientación
{{clear}}


[[Image:PlacePyConv10.png|frame|left|Código de Placement como y/p/r y Matriz de su [[Placement_API|API]].]]
position posición
{{clear}}


[[Image:PlacementDialogv10.png|frame|left|Panel de tareas de Placement o Ubicación]]
Hasta la etapa final de aceptación de la traducción no sustituiremos los términos originales en inglés por sus equivalentes en español.
{{clear}}


==Forms of Placement==


<div class="mw-translate-fuzzy">
==Tipos de Ubicación==
La ubicación es almacenada internamente como una posición y una rotación (el eje de rotación y el ángulo transformados en un cuaternión [https://en.wikipedia.org/wiki/Quaternions_and_spatial_rotation quaternion]). Mientras que hay diferentes formas de especificar una rotación, por ejemplo con un centro de rotación, esto se usa únicamente con fines de cálculo de rotación y no es almacenado para operaciones posteriores. De manera similar, si se especifica un eje de rotación de (1,1,1), puede ser normalizado cuando es almacenado en el cuaternión y aparece como (0.58, 0.58, 0.58) cuando se observa el objeto después.
</div>


===Angle, Axis and Position===


<div class="mw-translate-fuzzy">
'''Placement''' es el modo en que FreeCAD especifica la position y la attitude (orientacion) de un objeto en el espacio. Placement puede ser especificado de varias formas y manipulado a través de [[Python_scripting_tutorial#Vectors_and_Placements|scripting]], el panel de Propiedades o el diálogo '''Placement''' ('''Edit''' menu).
===Ángulo, Eje y Posición===
<br>
'''Placement = [Ángulo, Eje, Posición]'''
</div>


<div class="mw-translate-fuzzy">
La primera forma de '''Ubicación''' fija la localización de un objeto en el espacio con una posición, y describe su orientación como una simple rotación sobre un eje.
'''Ángulo = r''' es un escalar que indica la cantidad de rotación sobre un '''Eje'''. Se introduce en grados, pero
se almacena internamente en radianes.
</div>


'''Angle = r''' is a scalar indicating the amount of rotation of the object about '''Axis'''. Entered as degrees, but stored internally as radians.


<div class="mw-translate-fuzzy">
===Accediendo al Atributo Placement (emplazamiento)===
'''Eje = (ax,ay,az)''' Es un vector que describe un eje de rotación (Ver Nota sobre eje de rotación). Ejemplos:
(1,0,0) ==> sobre el eje '''X'''
(0,1,0) ==> sobre el eje '''Y'''
(0,0,1) ==> sobre el eje '''Z'''
(0.71,0.71,0) ==> sobre la línea '''y=x'''
</div>


(1,0,0) ==> about '''X''' axis
El atributo Placement (emplazamiento) de un objeto puede ser visto y modificado de 3 maneras:
(0,1,0) ==> about '''Y''' axis
(0,0,1) ==> about '''Z''' axis
(0.71,0.71,0) ==> about the line '''y=x'''


<div class="mw-translate-fuzzy">
[[Image:PlacementPropertiesv10-800x800.png|frame|left|Placement (emplazamiento) en el panel de Propiedades]]
Se puede observar que también es posible trasladar (mover) un objeto a lo largo de su eje de rotación (movimiento axial) introduciendo la distancia a mover en la casilla {{SpinBox|Axial: 0.0mm}} y pulsando el botón {{Button|Aplicar axial}}. (Una manera de visualizar el movimiento axial es pensando en un aeroplano con una hélice giratoria en su morro
-- la hélice gira ''alrededor'' de un eje de rotación mientras el avión se mueve ''a lo largo'' de ese mismo eje.)
Los valores del vector pueden ser pensados como la cantidad relativa de movimiento que se aplicará en esa dirección.
Por ejemplo, en el caso de que y=x (0.71,0.71,0) el valor contenido en la casilla Axial es aplicado en la misma medida en las direcciones X e Y, pero no aparece ningún movimiento en la dirección Z.
'''Posición= (x,y,z)''' Es un vector que describe el punto desde el que la geometría del objeto será calculada (de hecho, un "origen local" del objeto). Observe que en la programación, Placement.Base se usa para señalar el componente de Posición de un emplazamiento. El editor de propiedades llama a este valor '''Position''' y el panel de tareas de Placement o Ubicación lo llama '''Traslación'''.
</div>


'''Position = (x,y,z)''' is a Vector describing the point from which the object's geometry will be calculated (in effect, a "local origin" for the object). Note that in scripts, Placement.Base is used to denote the Position component of a placement. The property editor calls this value '''Position''' and the Placement task panel calls it '''Translation'''.
{{clear}}


===Position and Yaw, Pitch and Roll===
[[Image:PlacePyConv10.png|frame|left|Scripting Placement as y/p/r and Matrix and its [[Placement_API|API]].]]


<div class="mw-translate-fuzzy">
===Ángulos de Euler: Posición y Yaw (Guiñada), Pitch (Cabeceo) y Roll (Alabeo)===
Si en Rotación seleccionamos Ángulos de Euler aparecen estos campos:
[[Image:PlacementDialogv10b.png|frame|left|Placement task panel: {{ComboBox|Euler angles}} selected]]
{{clear}}
{{clear}}
'''Rotación = [Traslación, Guiñada-Cabeceo-Alabeo]'''
Roll (Alabeo) o Ángulo de rotación alrededor del eje X.
Pitch (Cabeceo) o Ángulo de rotación alrededor del eje Y.
Yaw (Guiñada) o Ángulo de rotación alrededor del eje Z.
Estos términos son usados en aviación.
</div>


'''Placement = [Position, Yaw-Pitch-Roll]'''
[[Image:PlacementDialogv10.png|frame|left|Placement Dialog]]


<div class="mw-translate-fuzzy">
{{clear}}
La segunda forma de '''Ubicación''' fija la localización de un objeto en el espacio con una '''Posición''' (como en la primera forma), pero describe su orientación usando los ángulos [http://en.wikipedia.org/wiki/Yaw,_pitch,_and_roll Yaw, Pitch y Roll]. Estos ángulos son llamados a veces [http://en.wikipedia.org/wiki/Euler_angles Ángulos de Euler] o Ángulos Tait-Bryan. Yaw, Pitch y Roll (Guiñada, Cabeceo y Alabeo) son términos usados habitualmente en aviación y se usan para la orientación de un Body (cuerpo).
<br>
</div>


'''Posición = (x,y,z)''' Es un vector que describe el punto desde el que la geometría del objeto será calculada (de hecho, un "origen local" del objeto).
==Formas de definir Placement==


<div class="mw-translate-fuzzy">
===Angulo, Eje y Posición===
'''Yaw-Pitch-Roll = (y,p,r)''' Es una tupla o agrupación de valores que especifica la orientación de un objeto. Los valores para y,p,r especifican los grados de rotación de cada uno de los ejes z,y,x (ver nota).
{{clear}}
{{Code|code=
>>> App.getDocument("Sin_nombre").Cylinder.Placement=App.Placement(App.Vector(0,0,0), App.Rotation(10,20,30), App.Vector(0,0,0))
}}
</div>


{{Code|code=
'''Placement = [Angle, Axis, Position]'''
>>> App.ActiveDocument.Cylinder.Placement = App.Placement(App.Vector(0,0,0), App.Rotation(10,20,30), App.Vector(0,0,0))
}}


App.Rotation(10,20,30) = Ángulo Euler
The primera forma de '''Placement''' define la situación de un objeto en el espacio con una Position, y describe su orientacion como una simple rotación alrededor de un eje.
'''Angle = r''' es un número que indica la magnitud de la rotación del objeto alrededor del eje. Se introduce en grados sexagesimales, pero internamente se almacena en radianes.


'''Yaw o Guiñada''' = 10 grados ('''Z''')
'''Axis = (ax,ay,az)''' es un vector que describe el eje de rotación (ver Nota sobre eje de rotación). Ejemplos:
(1,0,0) ==> giro respecto al eje '''X'''
(0,1,0) ==> giro respecto al eje '''Y'''
(0,0,1) ==> giro respecto al eje '''Z'''
(0.71,0.71,0) ==> giro respecto a la recta '''y=x , z=0'''
'''Position = (x,y,z)''' es un Vector que describe en coordenadas globales el punto (base) de referencia del objeto. Note que en los scripts, Placement.Base se usa para indicar la componente Position de un placement.
En el editor de propiedades, a ese valor se le llama "Position".


'''Pitch o Cabeceo''' = 20 grados ('''Y''')
<br>


'''Roll o Alabeo''' = 30 grados ('''X''')
===Position y (rumbo, asiento y escora) (Yaw, Pitch and Roll)===


'''Placement = [Position, Yaw-Pitch-Roll]'''


[[Image:Tache_Placement_Lacet_fr_Mini.gif|left]]'''Yaw o Guiñada''' es la rotación alrededor del '''eje Z''', es decir, una rotación de izquierda a derecha. <br />(El ángulo yaw es la '''Psi ψ''').
La segunda forma de '''Placement''' define la localización de un objeto en el espacio con una Position (como en la forma primera), pero describe su orientacion usando los ángulos de rumbo, asiento y escora (Yaw, Pitch and Roll) ([http://en.wikipedia.org/wiki/Yaw,_pitch,_and_roll Yaw, Pitch, Roll]). A esto ángulos también se los denomina ángulos de Euler o de Tait-Bryan([http://en.wikipedia.org/wiki/Euler_angles Euler angles]). Yaw, Pitch and Roll son términos usados en aviación (y navegación) para indicar la orientación (o attitude) de un cuerpo.
{{clear}}


[[Image:Tache_Placement_Tangage_fr_Mini.gif|left]]'''Pitch o Cabeceo''' es la rotación alrededor del '''eje Y''', es decir, morro arriba y morro abajo. <br />(El ángulo Pitch es la '''Phi φ''').
'''Position = (x,y,z)''' es un Vector que describe las coordenadas globales del punto de referencia del objeto.
{{clear}}


[[Image:Tache_Placement_Roulis_fr_Mini.gif|left]]'''Roll o Alabeo''' es la rotación alrededor del '''eje X''', es decir, ala arriba o abajo. <br />(El ángulo Roll es la '''Thêta θ''').
'''Yaw-Pitch-Roll = (y,p,r)''' es una terna o tripleta que especifica la attitude del objeto. Los valores de y,p,r indican grados sexagesimales de rotación respecto a cada uno de los ejes del sistema de referencia z,y,x (ver nota).
<br>
<center>
<gallery widths="300" heights="200">
Image:Tache_Placement_Lacet_fr_Mini.gif|'''Yaw''' es el ángulo de giro respecto al '''eje Z''', en el sentido de girar a la izquierda o a la derecha. (el ángulo yaw se suele representar con la letra griega '''Psi ψ''').
Image:Tache_Placement_Tangage_fr_Mini.gif|'''Pitch''' es rotación alrededor del '''eje Y''', "subir o bajar la nariz".
Image:Tache_Placement_Roulis_fr_Mini.gif|'''Roll''' es rotación alrededor del '''eje X''', es decir subir o bajar la punta del ala.
</gallery>
</center>
<br>
{{clear}}
{{clear}}


===Matrix===
===Matrix===


<div class="mw-translate-fuzzy">
'''Placement = Matrix'''
===Matriz===


'''Placement = Matriz'''
La tercera forma de '''Placement''' define la posición y orientación de un objeto en el espacio con una matriz de dimensiones 4x4 que representa una transformación afín ([http://en.wikipedia.org/wiki/Affine_transformation Affine Transformation]).
</div>


La tercera forma de '''Ubicación''' describe la posición y orientación del objeto con una matriz de transformación afín de 4x4 ([http://en.wikipedia.org/wiki/Affine_transformation Affine Transformation]).
'''Matrix''' =


'''Matriz''' =
((r11,r12,r13,t1),

<div class="mw-translate-fuzzy">
((r11,r12,r13,t1),
(r21,r22,r23,t2),
(r21,r22,r23,t2),
(r31,r32,r33,t3),
(r31,r32,r33,t3),
(0,0,0,1)) , donde rij indican rotación y ti indican translación.
(0,0,0,1)) , donde rij indica rotación y ti traslación.
{{clear}}
{{clear}}
</div>


==The Placement Dialog==
<br>


<div class="mw-translate-fuzzy">
==El diálogo Placement==
==La ventana de diálogo Ubicación==
La ventana de diálogo Ubicación es invocada desde el menú
'''Editar'''. Se usa para precisar la rotación/traslación de los objetos. También se usa cuando se necesita crear un boceto en un plano "no estándar" o para cambiar la
orientación de un boceto a un nuevo plano.
El apartado '''Traslación''' ajusta la localización del objeto en el espacio.
El apartado '''Centro''' ajusta el eje de rotación a uno que no pasa a través del punto de referencia del objeto.
El apartado '''Rotación''' ajusta el ángulo o ángulos de rotación y la manera de especificarlos.
</div>

* The '''Translation''' section adjusts the object's location in space.
* The '''Center''' section adjusts the rotational axis to one that does not pass through the object's reference point.
* The '''Rotation''' section adjusts the rotational angle(s) and the method of specifying those angles.


<div class="mw-translate-fuzzy">
The Placement Dialog es llamado desde el menu '''Edit'''. Se usa para rotar/trasladar los objetos con precisión. Tambien se usa cuando necesitamos crear un sketch (croquis) en un plano "no standard" o cambiar la orientación del plano del croquis a otro plano.
Pero mientras los elementos dentro de cada sección se aplican generalmente al propósito de cada sección, hay también algunos elementos en una sección que pueden afectar a los de otra sección. Por ejemplo, pinchando el botón de Puntos seleccionados en la sección '''Centro''' con 2 puntos seleccionados en la vista 3D, resulta no sólo el hecho de introducir las coordenadas en las casillas de '''Centro''' con las coordenadas de los puntos medios entre esos dos puntos seleccionados, sino que también crea un eje personalizado a lo largo de la línea definida por esos dos puntos seleccionados en la sección '''Rotación''' . Otro ejemplo es, introduciendo un valor en la casilla de Axial y pinchando el botón de Aplicar axial en la sección '''Traslación''' , traslada (mueve) el objeto a lo largo del eje definido en la sección '''Rotación''' .
La casilla '''Aplicar cambios incrementales''' es útil cuando las traslaciones/rotaciones se tienen que aplicar con respecto a la actual posición/orientación relativa del objeto. Pinchando esta casilla, los campos de diálogo de entrada se resetean a cero, pero no cambia la orientación o localización del objeto. La introducción de datos posteriores sí cambiarán la orientación/localización, pero son aplicados desde la actual posición del objeto. Habilitar esta casilla es útil también cuando se usa el botón de Puntos seleccionados para prevenir cambios de emplazamiento no deseados.
La sección '''Translation''' ajusta la localización del objeto en el espacio.
</div>
La sección '''Center''' ajusta el eje de rotación a uno que no pasa por el punto de referencia del objeto.
La sección '''Rotation''' ajusta el ángulo (o ángulos) de rotación, y el modo de especificar esos ángulos.
Marcar la casilla de selección '''aplica cambios incrementales sobre el placement (emplazamiento) del objeto''' es útil cuando las translations/rotations han de ser hechas respecto a las position/attitude actuales del objeto, en lugar de las position/attitude originales. Marcando esa casilla se resetea a cero los campos de entrada del cuadro de diálogo, aunque no cambia la orientation or location del objeto. Datos introducidos posteriormente cambian la orientation/location, pero se aplican a la posición actual del objeto.


The '''Apply incremental changes to object placement''' tick box is useful when translations/rotations are to be made relative the object's current position/attitude, rather than to the original position/attitude. Ticking this box resets the dialogue input fields to zero, but does not change the object's orientation or location. Subsequent entries do change the orientation/location, but are applied from the object's current position. Enabling this checkbox is also useful when using the Selected points button as it can sometimes prevent undesired placement changes.
<br>


<div class="mw-translate-fuzzy">
PD: Desde la versión 0.17, introduciendo nuevo objeto de Part, dicho objeto tiene su emplazamiento, y el emplazamiento del objeto creado en el objeto Part es incrementado con la Ubicación de Part. {{Version/es|0.17}}
Para obtener la Ubicación de Part, usar el siguiente código:
</div>


To obtain the Part Placement use this code:

{{Code|code=
import Draft, Part
sel = FreeCADGui.Selection.getSelection()
print(sel[0].Placement)
print(sel[0].getGlobalPlacement()) # return the GlobalPlacement
print(sel[0].getParentGeoFeatureGroup()) # return the GeoFeatureGroup, ex: Body or a Part.
print("____________________")
}}

<div class="mw-translate-fuzzy">
El botón de '''Puntos seleccionados''' se usa para introducir las coordenadas en la sección '''Centro''' en las casillas de coordenadas y adicionalmente (cuando se seleccionan 2 o 3 puntos) para crear un eje de rotación personalizado (definido por el usuario) en la sección '''Rotación''' . Un punto puede ser un vértice, pero puede ser también cualquier punto a lo largo de una arista o sobre una cara. Cuando se selecciona una arista o cara, la arista o cara son seleccionadas al completo, pero Freecad también recuerda sobre qué punto de la cara o arista se encontraba el puntero del ratón cuando esa arista o cara fueron seleccionadas. Son las coordenadas de ese punto las que se introducirán en la caja de diálogo de Ubicación cuando se pulse el botón de '''Puntos seleccionados''' . Se puede pensar que esta no es una manera muy precisa de seleccionar un punto, y es cierto, pero en muchos casos está suficientemente asegurado que ese punto seleccionado está en esa arista o cara. En los casos en los que se necesita designar un punto para ser usado con precisión, se debe seleccionar un vértice. Cuando no hay un vértice en la localización deseada, se debe considerar la creación de uno, quizás en un boceto temporal adjunto a esa cara o arista, o quizás usando un objeto del banco de trabajo Draft, como una línea o punto, etc.
</div>

<div class="mw-translate-fuzzy">
Vamos primero a considerar el simple caso de seleccionar un punto. El flujo de trabajo es, primero, seleccionar el punto deseado, después pulsar el botón '''Puntos seleccionados''' . Las coordenadas del punto seleccionado serán usadas para rellenar las casillas X, Y, y Z de la sección '''Centro''' . A partir de aquí cualquier rotación realizada al objeto será aplicada alrededor de este centro de rotación.
</div>

<div class="mw-translate-fuzzy">
Vamos ahora a considerar el caso de seleccionar 2 puntos. Hay que seleccionar los 2 puntos deseados, y entonces pulsar el botón '''Puntos seleccionados''' . Las coordenadas del punto medio entre los 2 puntos seleccionados quedan introducidas en las casillas X, Y, y Z de la sección '''Centro''' . A partir de aquí cualquier rotación realizada al objeto será aplicada alrededor de este centro de rotación. Pero además de establecer las coordenadas de la sección '''Centro''' como personalizadas (definidas por el usuario) , el eje es también añadido al elemento '''Eje''' de la sección '''Rotación''' . (Nota: Estando en el modo de rotación Euler, el modo cambia al modo de Rotación con un eje y el nuevo eje personalizado es seleccionado como el actual eje de rotación.) A partir de aquí cualquier rotación realizada usando el nuevo eje personalizado lo hará alrededor de este eje de rotación. Por añadidura, la distancia es medida entre los 2 puntos seleccionados, y esta información es mostrada en la Vista de informe. (Nota: Mantener pulsada la tecla Shift (Mayúsculas) mientras se presiona el botón '''Puntos seleccionados''' para copiar la medida de distancia al portapapeles.) Introduciendo esta distancia en la casilla Axial de la sección '''Traslación''' y pulsando el botón '''Aplicar axial''' se puede trasladar (mover) el objeto para que el primer punto seleccionado ocupe ahora las coordenadas ocupadas por el segundo punto seleccionado (en el momento en que el botón '''Puntos seleccionados''' fue pulsado).
</div>

<div class="mw-translate-fuzzy">
A continuación vamos a considerar el caso de seleccionar 3 puntos. Hay que seleccionar los 3 puntos deseados, y entonces pulsar el botón '''Puntos seleccionados''' . Las coordenadas del primer punto seleccionado (el orden de selección es muy importante aquí) quedan introducidas en las casillas X, Y, y Z de la sección '''Centro''' . Como 3 puntos definen un plano, FreeCAD es capaz de tomar ventaja de esto y usar estos 3 puntos para crear un nuevo eje de rotación personalizado (definido por el usuario) que es normal (perpendicular) a este plano definido. Al igual que seleccionando 2 puntos, la distancia entre puntos es también mostrada en la Vista de informe, pero esta vez es la distancia entre el segundo y el tercer punto seleccionado. (Nota: Mantener pulsada la tecla Shift (Mayúsculas) mientras se presiona el botón '''Puntos seleccionados''' -- Shift + Click -- para copiar la medida del ángulo al portapapeles.) Adicionalmente, el ángulo entre el segundo y el tercer punto es también medido y mostrado en la Vista de informe. Introduciendo este ángulo en la casilla '''Ángulo''' de la sección '''Rotación''' se puede rotar el objeto con mucha precisión, de forma que ahora el segundo punto seleccionado queda alineado con las coordenadas ocupadas por el tercer punto seleccionado. (Nota: Se puede incrementar el número de dígitos usados a través de la casilla del menú Editar -> Preferencias -> General -> Unidades -> Número de decimales si se desea una mayor precisión.)
</div>

==Examples==

<div class="mw-translate-fuzzy">
==Ejemplos==
==Ejemplos==
Rotaciones alrededor de un eje simple:
</div>


<div class="mw-translate-fuzzy">
Rotations alrededor de un solo eje:
[[Image:RotationAboutZBefore.png|600px|left|Before Rotation]] Antes de Rotación (Vista superior) {{clear}}
[[Image:RotationAboutZAfter.png|600px|right|After Rotation about Z]] Después de Rotación alrededor de Z (Vista superior) {{clear}}
[[Image:RotationAboutYXAfter.png|600px|right|After Rotation about y=x]] Después de Rotación alrededor de y=x (Vista desde la derecha) {{clear}}
Rotación con el punto central desplazado:
</div>


[[Image:RotationAboutZBefore.png|600px|left|Before Rotation]] Antes de la Rotation (visto desde arriba) {{clear}}
[[Image:RotationAboutZAfter.png|600px|right|After Rotation about Z]] After Rotation about Z (top view)
{{clear}}
<br>
[[Image:RotationAboutZAfter.png|600px|right|After Rotation about Z]] Después de Rotation respecto a Z (top view) {{clear}}
<br>
[[Image:RotationAboutYXAfter.png|600px|right|After Rotation about y=x]] Después de Rotation respecto a y=x (vista desde la derecha) {{clear}}


[[Image:RotationAboutYXAfter.png|600px|right|After Rotation about y=x]] After Rotation about y=x (right view)
{{clear}}


Rotation with offset centre point:
<br>
Rotation con centro de giro desplazado:


<div class="mw-translate-fuzzy">
[[Image:RotationOffsetBefore.png|600px|left|Before Rotation]] antes de la Rotation (top view) {{clear}}
[[Image:RotationOffsetBefore.png|600px|left|Before Rotation]] Antes de Rotación (Vista superior) {{clear}}
<br>
[[Image:RotationOffsetAfter.png|600px|right|After Rotation about Z]] Después de Rotation respecto a Z (vista en planta) {{clear}}
[[Image:RotationOffsetAfter.png|600px|right|After Rotation about Z]] Después de Rotación alrededor de Z (Vista superior) {{clear}}
Rotación usando ángulos de Euler:
</div>


[[Image:RotationOffsetAfter.png|600px|right|After Rotation about Z]] After Rotation about Z (top view)
<br>
{{clear}}
Rotation usando ángulos de Euler:


Rotation using Euler angles:
[[Image:RotationEulerBefore.png|600px|left|Before Rotation]] Antes Rotation {{clear}}
<br>
[[Image:RotationEulerAfter.png|600px|right|After Rotation]] Despues Rotation {{clear}}
<br>


[[Image:RotationEulerBefore.png|600px|left|Before Rotation]] Before Rotation
{{clear}}

[[Image:RotationEulerAfter.png|600px|right|After Rotation]] After Rotation
{{clear}}


==Placement.Base vs Shape Definition==
==Placement.Base vs Shape Definition==


<div class="mw-translate-fuzzy">
Placement no es la única forma de definir la posición de una forma en el espacio.
[[Image:RotationEulerBefore.png|600px|left|Before Rotation]] Antes de Rotación {{clear}}
Observa la consola de Python en esta imagen:
[[Image:RotationEulerAfter.png|600px|right|After Rotation]] Después de Rotación {{clear}}
==Placement.Base versus Definición de forma==
Placement o Ubicación no es la única manera de posicionar una forma en el espacio. Observando la consola de Python en esta imagen:
</div>


<div class="mw-translate-fuzzy">
[[Image:2Placements800.png|frame|left|2 Shapes with Same Placement]]{{clear}}
[[Image:2Placements800.png|frame|left|Dos formas con la misma Ubicación]]{{clear}}
</div>


<div class="mw-translate-fuzzy">
Los 2 cubos tienen el mismo valor de Placement, pero están en diferentes locations! Esto es así porque las 2 formas están definidas por vértices diferentes. Para las 2 formas de la ilustración superior:
Los dos cubos tienen el mismo valor de Ubicación, pero están en emplazamientos diferentes. Esto es porque las dos formas están definidas por vértices diferentes (curvas de formas más complejas). Para las dos formas de la ilustración anterior:
</div>


>>> ev = App.ActiveDocument.Extrude.Shape.Vertexes
>>> ev = App.ActiveDocument.Extrude.Shape.Vertexes
>>> for v in ev: print(v.X,",",v.Y,",",v.Z)
...
30.0,30.0,0.0
30.0,30.0,10.0
40.0,30.0,0.0
40.0,30.0,10.0
40.0,40.0,0.0
40.0,40.0,10.0
30.0,40.0,0.0
30.0,40.0,10.0
>>> e1v = App.ActiveDocument.Extrude001.Shape.Vertexes
>>> for v in e1v: print(v.X,",",v.Y,",",v.Z)
...
0.0,10.0,0.0
0.0,10.0,10.0
10.0,10.0,0.0
10.0,10.0,10.0
10.0,0.0,0.0
10.0,0.0,10.0
0.0,0.0,0.0
0.0,0.0,10.0
>>>

The Vertices (or Vectors) that define the shape use the Placement.Base attribute as their origin. So if you want to move a shape 10 units along the '''X''' axis, you could add 10 to the '''X''' coordinates of all the Vertices or you could set Placement.Base to (10,0,0).

==Using "Center" to Control Axis of Rotation==

<div class="mw-translate-fuzzy">
>>> ev = App.ActiveDocument.Extrude.Shape.Vertexes
>>> for v in ev: print v.X,",",v.Y,",",v.Z
>>> for v in ev: print v.X,",",v.Y,",",v.Z
...
...
Line 169: Line 317:
>>>
>>>
Los Vértices (or Vectors) que define la forma usan el atributo Placement.Base como su origen. Así, si quieres mover una forma 10 unidades a lo largo del eje '''X''', puedes añadir 10 a la coordenada '''X''' de todos los Vértices o, alternativamente, puedes establecer Placement.Position a (10,0,0).
Los vértices (o vectores) que definen la forma usan el atributo de Placement.Base como orígen. Así pues, si se desea mover una forma 10 unidades a lo largo del eje '''X''' , se debería añadir 10 a las coordenadas de '''X''' de todos los vértices o se podría establecer el valor de Placement.Base como (10,0,0).
==Uso de "Centro" para controlar el eje de rotación==
Por defecto, el eje de rotación no es realmente el eje x/y/z , sino una línea paralela al eje seleccionado, pero que pasa por el punto de referencia (Placement.Base) del objeto a rotar. Esto se puede cambiar usando los campos de Centro de la ventana de diálogo de Ubicación o, en programación, usando el parámetro Centro del constructor FreeCAD.Placement.
</div>


<div class="mw-translate-fuzzy">
<br>
Por ejemplo, suponiendo que tenemos un cubo (ver debajo) posicionado en (20,20,10).
[[Image:LocalZBefore2.png|frame|center|Antes de Rotación]]{{clear}}
Queremos girar el cubo alrededor de su propia línea de centro vertical (por ejemplo el eje Z local), pero manteniéndolo en su misma posición. Se puede conseguir fácilmente especificando un valor de Centro igual a las coordenadas del punto central del cubo (25,25,15).
[[Image:LocalZAfter2.png|frame|center|Después de Rotación]]{{clear}}
En programación, se haría como sigue:
</div>


[[Image:LocalZBefore2.png|frame|center|Before Rotation]]
==Usar "Center" para controlar el eje de rotación==
{{clear}}


We wish to spin the box around it's own vertical centre line (ie local Z), while keeping it the same position. We can easily achieve this by specifying a Center value equal to the coordinates of the box's central point (25,25,15).
Por defecto, el eje de rotación no es realmente el eje x/y/z. Es una linea paralela al eje seleccionado, pero pasando por el punto de referencia (Placement.Base) del objeto que va a ser rotado. Ese comportamiento puede ser cambiado usando los campos Center en el diálogo Placement o, en scripts, usando el parámetro Center del constructor FreeCAD.Placement .


[[Image:LocalZAfter2.png|frame|center|After Rotation]]
Por ejemplo, supongamos que tenemos un bloque (ver ilustración debajo) en las coordenadas (20,20,10).
{{clear}}
[[Image:LocalZBefore2.png|frame|center|Before Rotation]]{{clear}}
Queremos girarlo sobre su propio eje vertical (es decir el eje Z "local"), pero manteniéndolo en el mismo lugar. Podemos conseguirlo facilmente indicando como valor de Center las coordenadas del punto central del bloque, que son (25,25,15).
[[Image:LocalZAfter2.png|frame|center|After Rotation]]{{clear}}
<br>
En un script, haríamos así:


In a script, we would do:


{{Code|code=
<syntaxhighlight>
import FreeCAD
obj = App.ActiveDocument.Box # our box
obj = App.ActiveDocument.Box # our box
rot = FreeCAD.Rotation(FreeCAD.Vector(0,0,1),45) # 45° about Z
centre = FreeCAD.Vector(25,25,15) # central point of box
rot = FreeCAD.Rotation(FreeCAD.Vector(0,0,1),45) # 45° about Z
#rot = FreeCAD.Rotation(FreeCAD.Vector(1,0,1),45) # 45° about X and 45° about Z
pos = obj.Placement.Base # position point of box
#rot = FreeCAD.Rotation(10,20,30) # here example with Euler angle Yaw = 10 degrees (Z), Pitch = 20 degrees (Y), Roll = 30 degrees (X)
newplace = FreeCAD.Placement(pos,rot,centre) # make a new Placement object
obj.Placement = newplace # spin the box
centre = FreeCAD.Vector(25,25,15) # central point of box
pos = obj.Placement.Base # position point of box
</syntaxhighlight>
newplace = FreeCAD.Placement(pos,rot,centre) # make a new Placement object
obj.Placement = newplace # spin the box
}}


Los mismos comandos con el archivo de ejemplo [http://forum.freecadweb.org/download/file.php?id=1651 RotateCoG2.fcstd] (discusión en el [http://forum.freecadweb.org/viewtopic.php?f=3&t=3950#p31052 forum])
<br>


{{Code|code=
import FreeCAD
obj = App.ActiveDocument.Extrude # our box
rot = FreeCAD.Rotation(FreeCAD.Vector(0,0,1),45) # 45 about Z
#rot = FreeCAD.Rotation(FreeCAD.Vector(1,0,1),45) # 45° about X and 45° about Z
#rot = FreeCAD.Rotation(10,20,30) # here example with Euler angle Yaw = 10 degrees (Z), Pitch = 20 degrees (Y), Roll = 30 degrees (X)
centre = FreeCAD.Vector(25,25,0) # "centre" of rotation (where local Z cuts XY)
pos = obj.Placement.Base # original placement of obj
newplace = FreeCAD.Placement(pos,rot,centre) # make a new Placement object
obj.Placement = newplace # spin the box
}}

==Using Placement in expressions==

<div class="mw-translate-fuzzy">
==Uso de Placement en expresiones==
En expresiones es posible usar los componentes de la ubicación, por ejemplo para acceder al componente x del objeto llamado "Cubo":
{{Code|code=
<<Cubo>>.Placement.Base.x
}}
</div>

{{Code|code=
<<Cube>>.Placement.Base.x
}}

<div class="mw-translate-fuzzy">
Se puede acceder al àngulo de rotación mediante:
{{Code|code=
<<Cube>>.Placement.Rotation.Angle
}}
</div>

{{Code|code=
<<Cube>>.Placement.Rotation.Angle
}}

<div class="mw-translate-fuzzy">
Se puede acceder al eje de rotación con:
{{Code|code=
<<Cube>>.Placement.Rotation.Axis.x
<<Cube>>.Placement.Rotation.Axis.y
<<Cube>>.Placement.Rotation.Axis.z
}}
cuando uno de estos valores suele ser 1 mientras los otros son 0.
</div>

{{Code|code=
<<Cube>>.Placement.Rotation.Axis.x
<<Cube>>.Placement.Rotation.Axis.y
<<Cube>>.Placement.Rotation.Axis.z
}}

where often one of these values is 1 while the others are 0.

You can also use the whole Placement in a single expression:

<div class="mw-translate-fuzzy">
Se puede usar también la Ubicación al completo en una única expresión. Para ello:
Pinchar con el botón derecho del ratón sobre la propiedad Placement en el Editor de propiedades, seleccionar
"Mostrar todo" y aparecerán más propiedades adicionales. Si se vuelve a pinchar con el botón derecho otra vez sobre Placement, el menú contextual incluirá "Expresión...". Seleccionando Expresión se abrirá su caja de diálogo y lo que se introduzca irá a la propiedad de Placement en vez de a las propiedades hijas.
</div>

<div class="mw-translate-fuzzy">
Para hacer que la ubicación del "Boceto" sea la misma que la del "Cilindro", se debería introducir la expresión para el boceto de esta manera:
{{Code|code=
<<Cubo>>.Placement
}}
[[Image:PlacementInExpression.png|frame|left|Estableciendo la Ubicación completa en una sola expresión]]{{clear}}
</div>

{{Code|code=
<<Cube>>.Placement
}}

[[Image:PlacementInExpression.png|frame|left|Setting the whole Placement in one expression]]
{{clear}}

'''NOTE:''' It's also possible to ''create'' Placement objects in expressions. See the [[Expressions#Placement|Expressions]] page for details.

<span id="Notes"></span>
==Notas==
==Notas==

* Ejes y ángulo también pueden expresarse como un [http://en.wikipedia.org/wiki/Quaternions_and_spatial_rotation quaternion].
<div class="mw-translate-fuzzy">
* El punto de referencia de un objeto (FreeCAD.Placement.Base) puede ser distinto, según el objeto de que se trate. Ejemplos para algunos objetos usuales:
* Las propiedades de Ubicación (Placement) en la pestaña de datos aparecen como desactivadas en los objetos que están adjuntos a algún otro objeto. En ese caso, el desplazamiento (Attachment) del adjunto tiene que ser editado.
<br>
* Los ejes y el ángulo pueden ser también expresados como un cuaternión [http://en.wikipedia.org/wiki/Quaternions_and_spatial_rotation quaternion].
* El punto de referencia de un objeto puede ser diferente dependiendo del objeto. Algunos ejemplos para objetos comunes:
{| class="wikitable" border="1"
{| class="wikitable" border="1"
!Objeto!!Punto de referencia
!Object!!Reference Point
|- align="left"
|- align="left"
|Part.Cubo ||izquierda (minx), delante (miny), abajo (minz) vértice
|- align="left"
|Part.Esfera||centro de la esfera (por ejemplo centro de cuadro delimitador)
|- align="left"
|Part.Cilindro||centro de la cara inferior
|- align="left"
|Part.Cono||centro de la cara inferior (o la punta del cono si el radio inferior es 0)
|- align="left"
|Part.Toro||centro del toro
|- align="left"
|Resultados de operaciones derivadas de bocetos||la forma hereda la posición del boceto sobre el que reposa. Los bocetos comienzan siempre en la posición = (0,0,0). Esta posición corresponde al origen del boceto.
|}
</div>

{| class="wikitable" border="1"
!Object!!Reference Point
|- align="left"
|Part.Box ||left (minx), front (miny), bottom (minz) vertex
|Part.Box ||left (minx), front (miny), bottom (minz) vertex
|- align="left"
|- align="left"
Line 213: Line 474:
|Part.Torus||center of the torus
|Part.Torus||center of the torus
|- align="left"
|- align="left"
|Objetos formados a partir de Sketches||el objeto hereda la Position del Sketch subyacente. Los Sketches siempre se forman desde la Position = (0,0,0).
|Features derived from Sketches||the Feature inherits the Position of the underlying Sketch. Sketches always start with Position = (0,0,0). This position corresponds to the origin in the sketch.
|}
|}


<span id="More"></span>
{{clear}}
==Más==

<br>

==Versiones==
* A partir de la version 0.13, la modificación de las propiedades de Placement desde la pestaña Data ha sido desactivada para objetos creados con el entorno PartDesign, salvo para el sketch inicial a partir del cual se creó el sólido. En consecuencia, el Placement de un sólido creado en PartDesign a partir de un sketch solo puede ser modificado ajustando los parámetros Placement del sketch inicial de construcción (el primer sketch, desde el que se creó el sólido).

* La funcionalidad Placement será manejada eventualmente en el entorno Assembly workbench.

{{clear}}

<br>


<div class="mw-translate-fuzzy">
==Mas==
*El tutorial: [[Aeroplane|Aeroplane]] trata ampliamente los mecanismos de modificación del Placement de un objeto.
*Este tutorial: [[Aeroplane/es|Aeroplano]] abarca los mecanismos del cambio de ubicación de un objeto extensivamente.
</div>
*Puede encontrarse una explicación detallada, paso a paso, del diálogo Placement aquí: [[Tasks_Placement|Tasks_Placement]].


<br>
{{languages | {{en|Placement}} {{fr|Placement/fr}} {{it|Placement/it}} }}


{{Userdocnavi{{#translation:}}}}
[[Category:User Documentation]]

Latest revision as of 13:57, 27 May 2023

Overview

Introducción

Placement o Ubicación es el modo en que Freecad especifica la localización y la inclinación (orientación) de un objeto en el espacio. Placement puede ser especificado de múltiples formas y manipulado a través de Código, del Editor de propiedades o seleccionando desde el menú Editar → Ubicación... para abrir el Panel de tareas de Ubicación.

Accediendo a los atributos de Placement

Se puede acceder y modificar los atributos de Ubicación de un objeto de 3 maneras:

Accessing the Placement Attribute

An object's Placement attributes can be accessed and modified in 3 ways:

Placement o Ubicación en el panel de propiedades
Código de Placement como y/p/r y Matriz de su API.
Panel de tareas de Placement o Ubicación

Forms of Placement

Tipos de Ubicación

La ubicación es almacenada internamente como una posición y una rotación (el eje de rotación y el ángulo transformados en un cuaternión quaternion). Mientras que hay diferentes formas de especificar una rotación, por ejemplo con un centro de rotación, esto se usa únicamente con fines de cálculo de rotación y no es almacenado para operaciones posteriores. De manera similar, si se especifica un eje de rotación de (1,1,1), puede ser normalizado cuando es almacenado en el cuaternión y aparece como (0.58, 0.58, 0.58) cuando se observa el objeto después.

Angle, Axis and Position

Ángulo, Eje y Posición

Placement = [Ángulo, Eje, Posición]

La primera forma de Ubicación fija la localización de un objeto en el espacio con una posición, y describe su orientación como una simple rotación sobre un eje.

Ángulo = r es un escalar que indica la cantidad de rotación sobre un Eje. Se introduce en grados, pero se almacena internamente en radianes.

Angle = r is a scalar indicating the amount of rotation of the object about Axis. Entered as degrees, but stored internally as radians.

Eje = (ax,ay,az) Es un vector que describe un eje de rotación (Ver Nota sobre eje de rotación). Ejemplos:

   (1,0,0)       ==> sobre el eje X 
   (0,1,0)       ==> sobre el eje Y 
   (0,0,1)       ==> sobre el eje Z 
   (0.71,0.71,0) ==> sobre la línea y=x
   (1,0,0)       ==> about X axis
   (0,1,0)       ==> about Y axis
   (0,0,1)       ==> about Z axis
   (0.71,0.71,0) ==> about the line y=x

Se puede observar que también es posible trasladar (mover) un objeto a lo largo de su eje de rotación (movimiento axial) introduciendo la distancia a mover en la casilla Axial: 0.0mm y pulsando el botón Aplicar axial. (Una manera de visualizar el movimiento axial es pensando en un aeroplano con una hélice giratoria en su morro -- la hélice gira alrededor de un eje de rotación mientras el avión se mueve a lo largo de ese mismo eje.) Los valores del vector pueden ser pensados como la cantidad relativa de movimiento que se aplicará en esa dirección. Por ejemplo, en el caso de que y=x (0.71,0.71,0) el valor contenido en la casilla Axial es aplicado en la misma medida en las direcciones X e Y, pero no aparece ningún movimiento en la dirección Z.

Posición= (x,y,z) Es un vector que describe el punto desde el que la geometría del objeto será calculada (de hecho, un "origen local" del objeto). Observe que en la programación, Placement.Base se usa para señalar el componente de Posición de un emplazamiento. El editor de propiedades llama a este valor Position y el panel de tareas de Placement o Ubicación lo llama Traslación.

Position = (x,y,z) is a Vector describing the point from which the object's geometry will be calculated (in effect, a "local origin" for the object). Note that in scripts, Placement.Base is used to denote the Position component of a placement. The property editor calls this value Position and the Placement task panel calls it Translation.

Position and Yaw, Pitch and Roll

Ángulos de Euler: Posición y Yaw (Guiñada), Pitch (Cabeceo) y Roll (Alabeo)

Si en Rotación seleccionamos Ángulos de Euler aparecen estos campos:

Placement task panel: Euler angles selected

Rotación = [Traslación, Guiñada-Cabeceo-Alabeo] Roll (Alabeo) o Ángulo de rotación alrededor del eje X. Pitch (Cabeceo) o Ángulo de rotación alrededor del eje Y. Yaw (Guiñada) o Ángulo de rotación alrededor del eje Z. Estos términos son usados en aviación.

Placement = [Position, Yaw-Pitch-Roll]

La segunda forma de Ubicación fija la localización de un objeto en el espacio con una Posición (como en la primera forma), pero describe su orientación usando los ángulos Yaw, Pitch y Roll. Estos ángulos son llamados a veces Ángulos de Euler o Ángulos Tait-Bryan. Yaw, Pitch y Roll (Guiñada, Cabeceo y Alabeo) son términos usados habitualmente en aviación y se usan para la orientación de un Body (cuerpo).

Posición = (x,y,z) Es un vector que describe el punto desde el que la geometría del objeto será calculada (de hecho, un "origen local" del objeto).

Yaw-Pitch-Roll = (y,p,r) Es una tupla o agrupación de valores que especifica la orientación de un objeto. Los valores para y,p,r especifican los grados de rotación de cada uno de los ejes z,y,x (ver nota).

>>> App.getDocument("Sin_nombre").Cylinder.Placement=App.Placement(App.Vector(0,0,0), App.Rotation(10,20,30), App.Vector(0,0,0))
>>> App.ActiveDocument.Cylinder.Placement = App.Placement(App.Vector(0,0,0), App.Rotation(10,20,30), App.Vector(0,0,0))

App.Rotation(10,20,30) = Ángulo Euler

Yaw o Guiñada = 10 grados (Z)

Pitch o Cabeceo = 20 grados (Y)

Roll o Alabeo = 30 grados (X)


Yaw o Guiñada es la rotación alrededor del eje Z, es decir, una rotación de izquierda a derecha.
(El ángulo yaw es la Psi ψ).

Pitch o Cabeceo es la rotación alrededor del eje Y, es decir, morro arriba y morro abajo.
(El ángulo Pitch es la Phi φ).

Roll o Alabeo es la rotación alrededor del eje X, es decir, ala arriba o abajo.
(El ángulo Roll es la Thêta θ).

Matrix

Matriz

Placement = Matriz

La tercera forma de Ubicación describe la posición y orientación del objeto con una matriz de transformación afín de 4x4 (Affine Transformation).

Matriz =

((r11,r12,r13,t1),

   (r21,r22,r23,t2),
   (r31,r32,r33,t3),
   (0,0,0,1)) , donde rij indica rotación y ti traslación. 

The Placement Dialog

La ventana de diálogo Ubicación

La ventana de diálogo Ubicación es invocada desde el menú Editar. Se usa para precisar la rotación/traslación de los objetos. También se usa cuando se necesita crear un boceto en un plano "no estándar" o para cambiar la orientación de un boceto a un nuevo plano.

El apartado Traslación ajusta la localización del objeto en el espacio. El apartado Centro ajusta el eje de rotación a uno que no pasa a través del punto de referencia del objeto. El apartado Rotación ajusta el ángulo o ángulos de rotación y la manera de especificarlos.

  • The Translation section adjusts the object's location in space.
  • The Center section adjusts the rotational axis to one that does not pass through the object's reference point.
  • The Rotation section adjusts the rotational angle(s) and the method of specifying those angles.

Pero mientras los elementos dentro de cada sección se aplican generalmente al propósito de cada sección, hay también algunos elementos en una sección que pueden afectar a los de otra sección. Por ejemplo, pinchando el botón de Puntos seleccionados en la sección Centro con 2 puntos seleccionados en la vista 3D, resulta no sólo el hecho de introducir las coordenadas en las casillas de Centro con las coordenadas de los puntos medios entre esos dos puntos seleccionados, sino que también crea un eje personalizado a lo largo de la línea definida por esos dos puntos seleccionados en la sección Rotación . Otro ejemplo es, introduciendo un valor en la casilla de Axial y pinchando el botón de Aplicar axial en la sección Traslación , traslada (mueve) el objeto a lo largo del eje definido en la sección Rotación .

La casilla Aplicar cambios incrementales es útil cuando las traslaciones/rotaciones se tienen que aplicar con respecto a la actual posición/orientación relativa del objeto. Pinchando esta casilla, los campos de diálogo de entrada se resetean a cero, pero no cambia la orientación o localización del objeto. La introducción de datos posteriores sí cambiarán la orientación/localización, pero son aplicados desde la actual posición del objeto. Habilitar esta casilla es útil también cuando se usa el botón de Puntos seleccionados para prevenir cambios de emplazamiento no deseados.

The Apply incremental changes to object placement tick box is useful when translations/rotations are to be made relative the object's current position/attitude, rather than to the original position/attitude. Ticking this box resets the dialogue input fields to zero, but does not change the object's orientation or location. Subsequent entries do change the orientation/location, but are applied from the object's current position. Enabling this checkbox is also useful when using the Selected points button as it can sometimes prevent undesired placement changes.

PD: Desde la versión 0.17, introduciendo nuevo objeto de Part, dicho objeto tiene su emplazamiento, y el emplazamiento del objeto creado en el objeto Part es incrementado con la Ubicación de Part. introducido en la versión 0.17 Para obtener la Ubicación de Part, usar el siguiente código:

To obtain the Part Placement use this code:

import Draft, Part
sel = FreeCADGui.Selection.getSelection()
print(sel[0].Placement)
print(sel[0].getGlobalPlacement())   # return the GlobalPlacement
print(sel[0].getParentGeoFeatureGroup()) # return the GeoFeatureGroup, ex:  Body or a Part.
print("____________________")

El botón de Puntos seleccionados se usa para introducir las coordenadas en la sección Centro en las casillas de coordenadas y adicionalmente (cuando se seleccionan 2 o 3 puntos) para crear un eje de rotación personalizado (definido por el usuario) en la sección Rotación . Un punto puede ser un vértice, pero puede ser también cualquier punto a lo largo de una arista o sobre una cara. Cuando se selecciona una arista o cara, la arista o cara son seleccionadas al completo, pero Freecad también recuerda sobre qué punto de la cara o arista se encontraba el puntero del ratón cuando esa arista o cara fueron seleccionadas. Son las coordenadas de ese punto las que se introducirán en la caja de diálogo de Ubicación cuando se pulse el botón de Puntos seleccionados . Se puede pensar que esta no es una manera muy precisa de seleccionar un punto, y es cierto, pero en muchos casos está suficientemente asegurado que ese punto seleccionado está en esa arista o cara. En los casos en los que se necesita designar un punto para ser usado con precisión, se debe seleccionar un vértice. Cuando no hay un vértice en la localización deseada, se debe considerar la creación de uno, quizás en un boceto temporal adjunto a esa cara o arista, o quizás usando un objeto del banco de trabajo Draft, como una línea o punto, etc.

Vamos primero a considerar el simple caso de seleccionar un punto. El flujo de trabajo es, primero, seleccionar el punto deseado, después pulsar el botón Puntos seleccionados . Las coordenadas del punto seleccionado serán usadas para rellenar las casillas X, Y, y Z de la sección Centro . A partir de aquí cualquier rotación realizada al objeto será aplicada alrededor de este centro de rotación.

Vamos ahora a considerar el caso de seleccionar 2 puntos. Hay que seleccionar los 2 puntos deseados, y entonces pulsar el botón Puntos seleccionados . Las coordenadas del punto medio entre los 2 puntos seleccionados quedan introducidas en las casillas X, Y, y Z de la sección Centro . A partir de aquí cualquier rotación realizada al objeto será aplicada alrededor de este centro de rotación. Pero además de establecer las coordenadas de la sección Centro como personalizadas (definidas por el usuario) , el eje es también añadido al elemento Eje de la sección Rotación . (Nota: Estando en el modo de rotación Euler, el modo cambia al modo de Rotación con un eje y el nuevo eje personalizado es seleccionado como el actual eje de rotación.) A partir de aquí cualquier rotación realizada usando el nuevo eje personalizado lo hará alrededor de este eje de rotación. Por añadidura, la distancia es medida entre los 2 puntos seleccionados, y esta información es mostrada en la Vista de informe. (Nota: Mantener pulsada la tecla Shift (Mayúsculas) mientras se presiona el botón Puntos seleccionados para copiar la medida de distancia al portapapeles.) Introduciendo esta distancia en la casilla Axial de la sección Traslación y pulsando el botón Aplicar axial se puede trasladar (mover) el objeto para que el primer punto seleccionado ocupe ahora las coordenadas ocupadas por el segundo punto seleccionado (en el momento en que el botón Puntos seleccionados fue pulsado).

A continuación vamos a considerar el caso de seleccionar 3 puntos. Hay que seleccionar los 3 puntos deseados, y entonces pulsar el botón Puntos seleccionados . Las coordenadas del primer punto seleccionado (el orden de selección es muy importante aquí) quedan introducidas en las casillas X, Y, y Z de la sección Centro . Como 3 puntos definen un plano, FreeCAD es capaz de tomar ventaja de esto y usar estos 3 puntos para crear un nuevo eje de rotación personalizado (definido por el usuario) que es normal (perpendicular) a este plano definido. Al igual que seleccionando 2 puntos, la distancia entre puntos es también mostrada en la Vista de informe, pero esta vez es la distancia entre el segundo y el tercer punto seleccionado. (Nota: Mantener pulsada la tecla Shift (Mayúsculas) mientras se presiona el botón Puntos seleccionados -- Shift + Click -- para copiar la medida del ángulo al portapapeles.) Adicionalmente, el ángulo entre el segundo y el tercer punto es también medido y mostrado en la Vista de informe. Introduciendo este ángulo en la casilla Ángulo de la sección Rotación se puede rotar el objeto con mucha precisión, de forma que ahora el segundo punto seleccionado queda alineado con las coordenadas ocupadas por el tercer punto seleccionado. (Nota: Se puede incrementar el número de dígitos usados a través de la casilla del menú Editar -> Preferencias -> General -> Unidades -> Número de decimales si se desea una mayor precisión.)

Examples

Ejemplos

Rotaciones alrededor de un eje simple:

Before Rotation
Before Rotation
Antes de Rotación (Vista superior)
After Rotation about Z
After Rotation about Z
Después de Rotación alrededor de Z (Vista superior)
After Rotation about y=x
After Rotation about y=x
Después de Rotación alrededor de y=x (Vista desde la derecha)

Rotación con el punto central desplazado:

After Rotation about Z
After Rotation about Z

After Rotation about Z (top view)

After Rotation about y=x
After Rotation about y=x

After Rotation about y=x (right view)

Rotation with offset centre point:

Before Rotation
Before Rotation
Antes de Rotación (Vista superior)
After Rotation about Z
After Rotation about Z
Después de Rotación alrededor de Z (Vista superior)

Rotación usando ángulos de Euler:

After Rotation about Z
After Rotation about Z

After Rotation about Z (top view)

Rotation using Euler angles:

Before Rotation
Before Rotation

Before Rotation

After Rotation
After Rotation

After Rotation

Placement.Base vs Shape Definition

Before Rotation
Before Rotation
Antes de Rotación
After Rotation
After Rotation
Después de Rotación

Placement.Base versus Definición de forma

Placement o Ubicación no es la única manera de posicionar una forma en el espacio. Observando la consola de Python en esta imagen:

Dos formas con la misma Ubicación

Los dos cubos tienen el mismo valor de Ubicación, pero están en emplazamientos diferentes. Esto es porque las dos formas están definidas por vértices diferentes (curvas de formas más complejas). Para las dos formas de la ilustración anterior:

 >>> ev = App.ActiveDocument.Extrude.Shape.Vertexes
 >>> for v in ev: print(v.X,",",v.Y,",",v.Z)
 ...
 30.0,30.0,0.0
 30.0,30.0,10.0
 40.0,30.0,0.0
 40.0,30.0,10.0
 40.0,40.0,0.0
 40.0,40.0,10.0
 30.0,40.0,0.0
 30.0,40.0,10.0
 >>> e1v = App.ActiveDocument.Extrude001.Shape.Vertexes
 >>> for v in e1v: print(v.X,",",v.Y,",",v.Z)
 ...
 0.0,10.0,0.0
 0.0,10.0,10.0
 10.0,10.0,0.0
 10.0,10.0,10.0
 10.0,0.0,0.0
 10.0,0.0,10.0
 0.0,0.0,0.0
 0.0,0.0,10.0
 >>>

The Vertices (or Vectors) that define the shape use the Placement.Base attribute as their origin. So if you want to move a shape 10 units along the X axis, you could add 10 to the X coordinates of all the Vertices or you could set Placement.Base to (10,0,0).

Using "Center" to Control Axis of Rotation

>>> ev = App.ActiveDocument.Extrude.Shape.Vertexes

 >>> for v in ev: print v.X,",",v.Y,",",v.Z
 ... 
 30.0,30.0,0.0
 30.0,30.0,10.0
 40.0,30.0,0.0
 40.0,30.0,10.0
 40.0,40.0,0.0
 40.0,40.0,10.0
 30.0,40.0,0.0
 30.0,40.0,10.0
 >>> e1v = App.ActiveDocument.Extrude001.Shape.Vertexes
 >>> for v in e1v: print v.X,",",v.Y,",",v.Z
 ... 
 0.0,10.0,0.0
 0.0,10.0,10.0
 10.0,10.0,0.0
 10.0,10.0,10.0
 10.0,0.0,0.0
 10.0,0.0,10.0
 0.0,0.0,0.0
 0.0,0.0,10.0
 >>> 
 

Los vértices (o vectores) que definen la forma usan el atributo de Placement.Base como orígen. Así pues, si se desea mover una forma 10 unidades a lo largo del eje X , se debería añadir 10 a las coordenadas de X de todos los vértices o se podría establecer el valor de Placement.Base como (10,0,0).

Uso de "Centro" para controlar el eje de rotación

Por defecto, el eje de rotación no es realmente el eje x/y/z , sino una línea paralela al eje seleccionado, pero que pasa por el punto de referencia (Placement.Base) del objeto a rotar. Esto se puede cambiar usando los campos de Centro de la ventana de diálogo de Ubicación o, en programación, usando el parámetro Centro del constructor FreeCAD.Placement.

Por ejemplo, suponiendo que tenemos un cubo (ver debajo) posicionado en (20,20,10).

Antes de Rotación

Queremos girar el cubo alrededor de su propia línea de centro vertical (por ejemplo el eje Z local), pero manteniéndolo en su misma posición. Se puede conseguir fácilmente especificando un valor de Centro igual a las coordenadas del punto central del cubo (25,25,15).

Después de Rotación

En programación, se haría como sigue:

Before Rotation

We wish to spin the box around it's own vertical centre line (ie local Z), while keeping it the same position. We can easily achieve this by specifying a Center value equal to the coordinates of the box's central point (25,25,15).

After Rotation

In a script, we would do:

import FreeCAD
obj = App.ActiveDocument.Box                       # our box
rot = FreeCAD.Rotation(FreeCAD.Vector(0,0,1),45)   # 45° about Z
#rot = FreeCAD.Rotation(FreeCAD.Vector(1,0,1),45)   # 45° about X and 45° about Z
#rot = FreeCAD.Rotation(10,20,30)                   # here example with Euler angle Yaw = 10 degrees (Z), Pitch = 20 degrees (Y), Roll = 30 degrees (X)
centre = FreeCAD.Vector(25,25,15)                  # central point of box
pos = obj.Placement.Base                           # position point of box
newplace = FreeCAD.Placement(pos,rot,centre)       # make a new Placement object
obj.Placement = newplace                           # spin the box

Los mismos comandos con el archivo de ejemplo RotateCoG2.fcstd (discusión en el forum)

import FreeCAD
obj = App.ActiveDocument.Extrude                    # our box
rot = FreeCAD.Rotation(FreeCAD.Vector(0,0,1),45)    # 45 about Z
#rot = FreeCAD.Rotation(FreeCAD.Vector(1,0,1),45)    # 45° about X and 45° about Z
#rot = FreeCAD.Rotation(10,20,30)                    # here example with Euler angle Yaw = 10 degrees (Z), Pitch = 20 degrees (Y), Roll = 30 degrees (X)
centre = FreeCAD.Vector(25,25,0)                    # "centre" of rotation (where local Z cuts XY)
pos = obj.Placement.Base                            # original placement of obj
newplace = FreeCAD.Placement(pos,rot,centre)        # make a new Placement object
obj.Placement = newplace                            # spin the box

Using Placement in expressions

Uso de Placement en expresiones

En expresiones es posible usar los componentes de la ubicación, por ejemplo para acceder al componente x del objeto llamado "Cubo":

<<Cubo>>.Placement.Base.x
<<Cube>>.Placement.Base.x

Se puede acceder al àngulo de rotación mediante:

<<Cube>>.Placement.Rotation.Angle
<<Cube>>.Placement.Rotation.Angle

Se puede acceder al eje de rotación con:

<<Cube>>.Placement.Rotation.Axis.x
<<Cube>>.Placement.Rotation.Axis.y
<<Cube>>.Placement.Rotation.Axis.z

cuando uno de estos valores suele ser 1 mientras los otros son 0.

<<Cube>>.Placement.Rotation.Axis.x
<<Cube>>.Placement.Rotation.Axis.y
<<Cube>>.Placement.Rotation.Axis.z

where often one of these values is 1 while the others are 0.

You can also use the whole Placement in a single expression:

Se puede usar también la Ubicación al completo en una única expresión. Para ello: Pinchar con el botón derecho del ratón sobre la propiedad Placement en el Editor de propiedades, seleccionar "Mostrar todo" y aparecerán más propiedades adicionales. Si se vuelve a pinchar con el botón derecho otra vez sobre Placement, el menú contextual incluirá "Expresión...". Seleccionando Expresión se abrirá su caja de diálogo y lo que se introduzca irá a la propiedad de Placement en vez de a las propiedades hijas.

Para hacer que la ubicación del "Boceto" sea la misma que la del "Cilindro", se debería introducir la expresión para el boceto de esta manera:

<<Cubo>>.Placement
Estableciendo la Ubicación completa en una sola expresión
<<Cube>>.Placement
Setting the whole Placement in one expression

NOTE: It's also possible to create Placement objects in expressions. See the Expressions page for details.

Notas

  • Las propiedades de Ubicación (Placement) en la pestaña de datos aparecen como desactivadas en los objetos que están adjuntos a algún otro objeto. En ese caso, el desplazamiento (Attachment) del adjunto tiene que ser editado.
  • Los ejes y el ángulo pueden ser también expresados como un cuaternión quaternion.
  • El punto de referencia de un objeto puede ser diferente dependiendo del objeto. Algunos ejemplos para objetos comunes:
Objeto Punto de referencia
Part.Cubo izquierda (minx), delante (miny), abajo (minz) vértice
Part.Esfera centro de la esfera (por ejemplo centro de cuadro delimitador)
Part.Cilindro centro de la cara inferior
Part.Cono centro de la cara inferior (o la punta del cono si el radio inferior es 0)
Part.Toro centro del toro
Resultados de operaciones derivadas de bocetos la forma hereda la posición del boceto sobre el que reposa. Los bocetos comienzan siempre en la posición = (0,0,0). Esta posición corresponde al origen del boceto.
Object Reference Point
Part.Box left (minx), front (miny), bottom (minz) vertex
Part.Sphere center of the sphere (ie centre of bounding box)
Part.Cylinder center of the bottom face
Part.Cone center of bottom face (or apex if bottom radius is 0)
Part.Torus center of the torus
Features derived from Sketches the Feature inherits the Position of the underlying Sketch. Sketches always start with Position = (0,0,0). This position corresponds to the origin in the sketch.

Más

  • Este tutorial: Aeroplano abarca los mecanismos del cambio de ubicación de un objeto extensivamente.