Std ViewScreenShot/es: Difference between revisions

From FreeCAD Documentation
(Updating to match new version of source page)
(Updating to match new version of source page)
 
(8 intermediate revisions by the same user not shown)
Line 1: Line 1:
<languages/>
<languages/>

{{Docnav
|[[Std_DlgParameter|DlgParameter]]
|[[Std_ViewLoadImage|ViewLoadImage]]
|[[Std_Tools_Menu|Std Tools Menu]]
|IconL=Std_DlgParameter.svg
|IconR=Std_ViewLoadImage.svg
|IconC=Freecad.svg
}}

<div class="mw-translate-fuzzy">
<div class="mw-translate-fuzzy">
{{GuiCommand/es|Name=Std_ViewScreenShot|MenuLocation=[[Std Tools Menu/es|Herramientas]] -> Guardar imagen...|Workbenches=Todos|SeeAlso=...}}
{{GuiCommand/es|Name=Std_ViewScreenShot|MenuLocation=[[Std Tools Menu/es|Herramientas]] -> Guardar imagen...|Workbenches=Todos|SeeAlso=...}}
</div>
</div>

==Description==


<div class="mw-translate-fuzzy">
<div class="mw-translate-fuzzy">
Line 8: Line 20:


Este comando abre un letrero de diálogo para guardar el contenido actual de la vista 3D en un archivo que puede ser de diversos formatos de imagen. Adicionalmente, puedes cambiar el ratio de aspecto y la resolución de la captura de pantalla utilizando el botón de "Opciones" para tener acceso a más parámetros.
Este comando abre un letrero de diálogo para guardar el contenido actual de la vista 3D en un archivo que puede ser de diversos formatos de imagen. Adicionalmente, puedes cambiar el ratio de aspecto y la resolución de la captura de pantalla utilizando el botón de "Opciones" para tener acceso a más parámetros.
</div>

<div class="mw-translate-fuzzy">
Este comando también puede utilizar el campo de comentario de imagen de algunos tipos de imágenes, como PNG o JPEG para guardar información [[MIBA/es|MIBA]] con la imagen.
</div>
</div>

[[Image:Save_picture.png|800px]]
{{Caption|The Save picture dialog box after pressing the Extended button}}


==Usage==
==Usage==


# Select the {{MenuCommand|Tools → [[Image:Std_ViewScreenShot.svg|16px]] Save image...}} option from the menu.
# There are several ways to invoke this command:
# The Save image dialog box opens.
#* Pressing the {{KEY|[[File:Std ViewScreenShot.svg|16px|Std ViewScreenShot|link=Std ViewScreenShot]] [[Std ViewScreenShot|Std ViewScreenShot]]}} button in the toolbar
# Optionally press the {{Button|Extended}} button to reveal an additional panel in the dialog box. For more information see [[#Options|Options]].
#* Using the {{MenuCommand|{{StdMenu|[[Std Tools Menu|Tools]]}} → Save picture...}} menu.
# Optionally browse to the correct folder.
#* via [[#Scripting|Python scripting]]
# Enter a filename and select the file type.
'''Result:''' A dialog will open requesting some parameters
# Press the {{Button|Save}} button to create the image file and close the dialog box.


==Options==
==Options==


===Image dimensions===
<div class="mw-translate-fuzzy">
==== Formatos de imagen ====
FreeCAD utiliza los tipos construidos en QT y algún plugin de QT en el directorio bin/imageformates para guardar las imágenes. Así que dependerá de tu plataforma los tipos de formatos que puedas escoger.
==== Letrero de diálogo ====
</div>


# Select a standard size from the '''Standard sizes''' dropdown list. Or specify the '''Width''' and '''Height''' for a custom size.
[[Image:Save_picture.png|550px]]
# Optionally press an '''Aspect ratio''' button to set the width-to-height ratio of the image. If the '''Width''' input box has the focus the height of the image will change and vice versa.


===== Tamaño de imagen =====
===Image properties===
Los parámetros de tamaño de imagen están definidos por el tamaño de la pantalla de la vista 3D activa. Pero puedes cambiarlos a cualquier valor que quieras. Algunos drivers OpenGL no permiten renderizar a más de 8000 pixels. Depende de tu sistema.


# Select an option from the '''Background''' dropdown list:
Con los cuatro botones puedes cambiar el aspecto a un valor determinado.
#* {{Value|Current}} This option uses the background of the 3D view.
#* {{Value|White}}
#* {{Value|Black}}
#* {{Value|Transparent}} Not all image formats support transparency.
# Select an option from the '''Creation method''' dropdown list:
#* {{Value|Offscreen (New)}} This is the default method. This method supports [https://en.wikipedia.org/wiki/Multisample_anti-aliasing anti-aliasing]. ''Technical information: The most important classes for this method are Qt's QOffscreenSurface and QOpenGLFramebufferObject.''
#* {{Value|Offscreen (Old)}} This method does not work on many modern Linux systems as it relies on the graphics driver. This method does not support anti-aliasing. ''Technical information: This is a real off-screen rendering method that only uses functions from the Coin3d library.''
#* {{Value|Framebuffer (custom)}} This method supports anti-aliasing. ''Technical information: If anti-aliasing is off, this method reads the image directly from the graphics renderer, else it renders to a framebuffer and gets the image from there. The key part of this method is Qt's QOpenGLFramebufferObject class.''
#* {{Value|Framebuffer (as is)}} This method uses the same techniques as '''Framebuffer (custom)'''. It also supports anti-aliasing but has some limitations related to custom sizes and always uses the current background of the 3D view.


===== Imagen de fondo =====
===Image comment===


# Select the {{RadioButton|TRUE|Insert MIBA}} option to add [[MIBA]] information to the file. Not all image formats support this.
Con este combo box puedes seleccionar la imagen de fondo de la imagen que crees.
# Or select the {{RadioButton|TRUE|Insert comment}} option and type a comment in the text field to embed a comment in the file. Not all image formats support this.
* '''Actual''' utiliza la imagen de fondo de la vista actual (como se ha seleccionado en las preferencias)
# Check the {{CheckBox|TRUE|Add watermark}} checkbox to add a watermark. The watermark is placed in the lower left corner of the image and consists of the FreeCAD logo and name above the main FreeCAD URL: [http://www.freecadweb.org www.freecadweb.org].
* '''Blanco''' crea una imagen con el fondo blanco (por ejemplo para su impresión)
* '''Negro''' imagen de fondo negra
* '''Transparente''' crea un fondo transparente en los formatos de imagen que soportan transparencia


==Notes==
===== Creation method =====
With this combo box you can set how the image data is collected (rendered):
* '''Framebuffer (custom)''': It uses the same technique as '''Framebuffer (as is)'''. Additionally it allows to set custom sizes and the background.
* '''Framebuffer (as is)''': If [https://en.wikipedia.org/wiki/Multisample_anti-aliasing multi-sampling anti-aliasing] is off, it reads the image directly from the graphic renderer. If multi-sampling is on, it renders to a framebuffer and gets the image from there. (The key part of this method is Qt's QOpenGLFramebufferObject class.)
* '''Offscreen (new)''': This is the default method. It is a replacement/alternative for the '''Offscreen (old)''' rendering. Additionally it supports multi-sampling. (The most important classes are Qt's QOffscreenSurface and QOpenGLFramebufferObject.)
* '''Offscreen (old)''': It only uses functions from the library Coin3d. This method does not support multi-sampling, relies heavily on graphic driver and on many modern Linux systems it does not work. It is a real off-screen rendering method that doesn't require an OpenGL window.


* The number of available image file formats may vary depending on your OS.
To turn on multi-sampling (anti-aliasing), use the option '''[[Preferences_Editor#3D_View|Anti-Aliasing]]''' in the [[Preferences_Editor|preferences]].
* Some OpenGL drivers don't allow renderings above a certain maximum size.


==Preferences==
<div class="mw-translate-fuzzy">
===== Comentarios =====
Algunos formatos de imágenes pueden transportar un comentario con las imágenes. En caso de que selecciones uno de estos formatos puedes introducir un comentario o utilizar el campo Comentario para la información [[MIBA/es|MIBA]].
</div>


* The 3D view background can be changed in the preferences: {{MenuCommand|Edit → Preferences... → Display → Colors → Background color}}. See [[Preferences_Editor#Colors|Preferences Editor]].
<div class="mw-translate-fuzzy">
* To change the 3D view anti-aliasing: {{MenuCommand|Edit → Preferences... → Display → 3D view → Rendering → Anti-Aliasing}}. See [[Preferences_Editor#3D_View|Preferences Editor]].
==== Archivos de guión ====

==Scripting==

It is possible to create screenshots with python code.


También es posible guardar la imagen desde Python:
</div>
{{Code|code=
{{Code|code=
Gui.ActiveDocument.ActiveView.saveImage('C:/temp/test.png',1656,783,'Current')
Gui.ActiveDocument.ActiveView.saveImage('C:/temp/test.png',1656,783,'Current')
}}
}}

Este archivo de guión crea una serie de imágenes de diferentes tamaños y de diferentes puntos de vista. El tipo de la cámara, por ejemplo ortográfica o perspectiva también se puede cambiar.
This script saves a series of screenshots of different sizes and from different directions. The camera type, orthographic or perspective, is also changed.


{{Code|code=
{{Code|code=
import Part,PartGui
import Part, PartGui
# loading test part
# Loading test part
Part.open("C:/Documents and Settings/jriegel/My Documents/Projects/FreeCAD/data/Blade.stp")
Part.open('C:/Documents and Settings/jriegel/My Documents/Projects/FreeCAD/data/Blade.stp')
OutDir = 'c:/temp/'
OutDir = 'C:/temp/'
# creating images with different Views, Cameras and sizes
# Creating images with different Views, Cameras and sizes
for p in ["PerspectiveCamera","OrthographicCamera"]:
for p in ['PerspectiveCamera','OrthographicCamera']:
Gui.SendMsgToActiveView(p)
Gui.SendMsgToActiveView(p)
for f in ["ViewAxo","ViewFront","ViewTop"]:
for f in ['ViewAxo','ViewFront','ViewTop']:
Gui.SendMsgToActiveView(f)
Gui.SendMsgToActiveView(f)
for x,y in [[500,500],[1000,3000],[3000,1000],[3000,3000],[8000,8000]]:
for x,y in [[500,500],[1000,3000],[3000,1000],[3000,3000],[8000,8000]]:
Gui.ActiveDocument.ActiveView.saveImage(OutDir + "Blade_" + p +"_" + f + "_" + `x` + "_" + `y` + ".jpg",x,y,"White")
Gui.ActiveDocument.ActiveView.saveImage(OutDir + 'Blade_' + p +'_' + f + '_' + `x` + '_' + `y` + '.jpg',x,y,'White')
Gui.ActiveDocument.ActiveView.saveImage(OutDir + "Blade_" + p +"_" + f + "_" + `x` + "_" + `y` + ".png",x,y,"Transparent")
Gui.ActiveDocument.ActiveView.saveImage(OutDir + 'Blade_' + p +'_' + f + '_' + `x` + '_' + `y` + '.png',x,y,'Transparent')


# close active document
# Close active document
App.closeDocument(App.ActiveDocument.Name)
App.closeDocument(App.ActiveDocument.Name)
}}
}}


{{Std Base navi}}


{{Docnav
{{Userdocnavi}}
|[[Std_DlgParameter|DlgParameter]]
{{clear}}
|[[Std_ViewLoadImage|ViewLoadImage]]
|[[Std_Tools_Menu|Std Tools Menu]]
|IconL=Std_DlgParameter.svg
|IconR=Std_ViewLoadImage.svg
|IconC=Freecad.svg
}}

{{Std Base navi{{#translation:}}}}
{{Userdocnavi{{#translation:}}}}

Latest revision as of 16:32, 14 April 2023

Std_ViewScreenShot

Ubicación en el Menú
Herramientas -> Guardar imagen...
Entornos de trabajo
Todos
Atajo de teclado por defecto
Ninguno
Introducido en versión
-
Ver también
...

Description

Sinopsis

Este comando abre un letrero de diálogo para guardar el contenido actual de la vista 3D en un archivo que puede ser de diversos formatos de imagen. Adicionalmente, puedes cambiar el ratio de aspecto y la resolución de la captura de pantalla utilizando el botón de "Opciones" para tener acceso a más parámetros.

The Save picture dialog box after pressing the Extended button

Usage

  1. Select the Tools → Save image... option from the menu.
  2. The Save image dialog box opens.
  3. Optionally press the Extended button to reveal an additional panel in the dialog box. For more information see Options.
  4. Optionally browse to the correct folder.
  5. Enter a filename and select the file type.
  6. Press the Save button to create the image file and close the dialog box.

Options

Image dimensions

  1. Select a standard size from the Standard sizes dropdown list. Or specify the Width and Height for a custom size.
  2. Optionally press an Aspect ratio button to set the width-to-height ratio of the image. If the Width input box has the focus the height of the image will change and vice versa.

Image properties

  1. Select an option from the Background dropdown list:
    • Current This option uses the background of the 3D view.
    • White
    • Black
    • Transparent Not all image formats support transparency.
  2. Select an option from the Creation method dropdown list:
    • Offscreen (New) This is the default method. This method supports anti-aliasing. Technical information: The most important classes for this method are Qt's QOffscreenSurface and QOpenGLFramebufferObject.
    • Offscreen (Old) This method does not work on many modern Linux systems as it relies on the graphics driver. This method does not support anti-aliasing. Technical information: This is a real off-screen rendering method that only uses functions from the Coin3d library.
    • Framebuffer (custom) This method supports anti-aliasing. Technical information: If anti-aliasing is off, this method reads the image directly from the graphics renderer, else it renders to a framebuffer and gets the image from there. The key part of this method is Qt's QOpenGLFramebufferObject class.
    • Framebuffer (as is) This method uses the same techniques as Framebuffer (custom). It also supports anti-aliasing but has some limitations related to custom sizes and always uses the current background of the 3D view.

Image comment

  1. Select the Insert MIBA option to add MIBA information to the file. Not all image formats support this.
  2. Or select the Insert comment option and type a comment in the text field to embed a comment in the file. Not all image formats support this.
  3. Check the Add watermark checkbox to add a watermark. The watermark is placed in the lower left corner of the image and consists of the FreeCAD logo and name above the main FreeCAD URL: www.freecadweb.org.

Notes

  • The number of available image file formats may vary depending on your OS.
  • Some OpenGL drivers don't allow renderings above a certain maximum size.

Preferences

  • The 3D view background can be changed in the preferences: Edit → Preferences... → Display → Colors → Background color. See Preferences Editor.
  • To change the 3D view anti-aliasing: Edit → Preferences... → Display → 3D view → Rendering → Anti-Aliasing. See Preferences Editor.

Scripting

It is possible to create screenshots with python code.

Gui.ActiveDocument.ActiveView.saveImage('C:/temp/test.png',1656,783,'Current')

This script saves a series of screenshots of different sizes and from different directions. The camera type, orthographic or perspective, is also changed.

import Part, PartGui
# Loading test part
Part.open('C:/Documents and Settings/jriegel/My Documents/Projects/FreeCAD/data/Blade.stp')
OutDir = 'C:/temp/'
 
# Creating images with different Views, Cameras and sizes
for p in ['PerspectiveCamera','OrthographicCamera']:
    Gui.SendMsgToActiveView(p)
    for f in ['ViewAxo','ViewFront','ViewTop']:
        Gui.SendMsgToActiveView(f)
        for x,y in [[500,500],[1000,3000],[3000,1000],[3000,3000],[8000,8000]]:
            Gui.ActiveDocument.ActiveView.saveImage(OutDir + 'Blade_' + p +'_' + f + '_' + `x` + '_' + `y` + '.jpg',x,y,'White')
            Gui.ActiveDocument.ActiveView.saveImage(OutDir + 'Blade_' + p +'_' + f + '_' + `x` + '_' + `y` + '.png',x,y,'Transparent')

# Close active document
App.closeDocument(App.ActiveDocument.Name)