Print#

The print commands are used to print selected canvas objects to a file or to a Windows or PostScript printer and to control the format of the printed output.

Object features#

EpsOptions#

class EpsOptions[source]#

The EpsOptions object stores the settings that Abaqus uses when printing using Encapsulated PostScript format. The EpsOptions object has no constructor. Abaqus creates the epsOptions member when a session is started.

Notes

This object can be accessed by:

session.epsOptions

Methods

setValues([imageSize, units, resolution, ...])

This method modifies the EpsOptions object.

setValues(imageSize: SymbolicConstantType | float = 'SIZE_ON_SCREEN', units: SymbolicConstantType = 'INCHES', resolution: SymbolicConstantType = 'DPI_150', fontType: SymbolicConstantType = 'PS_IF_AVAILABLE', imageFormat: SymbolicConstantType = 'VECTOR', shadingQuality: SymbolicConstantType = 'MEDIUM')[source]#

This method modifies the EpsOptions object.

Parameters:
imageSize

The SymbolicConstant SIZE_ON_SCREEN or a pair of Floats specifying the width and height of the image in the units specified by units. Possible numeric values are imageSize ≥≥ (minWidth, minHeight). The default value is SIZE_ON_SCREEN.Note:The minimum value of width and height (minWidth and minHeight) is 10 mm (approximately 0.4 inches).

units

A SymbolicConstant specifying the units of the imageSize argument. This argument is ignored if imageSize is SIZE_ON_SCREEN. Possible values are INCHES and MM. The default value is INCHES.

resolution

A SymbolicConstant specifying the resolution of the image in dots per inch (dpi). The resolution can be DPI_1200 only if *imageFormat*=VECTOR. Possible values are DPI_75, DPI_150, DPI_300, DPI_450, DPI_600, and DPI_1200. The default value is DPI_150.

fontType

A SymbolicConstant specifying the PostScript font substitution rules to be applied. Possible values are PS_ALWAYS, PS_IF_AVAILABLE, and AS_DISPLAYED. The default value is PS_IF_AVAILABLE.

imageFormat

A SymbolicConstant specifying how the viewport display will be represented. Possible values are VECTOR and RASTER. The default value is VECTOR.

shadingQuality

A SymbolicConstant specifying how fine the shading of curved surfaces will be for vector images. Possible values are EXTRA COARSE, COARSE, MEDIUM, FINE, and EXTRA FINE. The default value is MEDIUM.

Raises:
RangeError
  • If either element of imageSize is out of range: RangeError: imageSize must be SIZE_ON_SCREEN or a sequence of 2 Floats >= (minWidth,

minHeight)

PageSetupOptions#

class PageSetupOptions[source]#

The PageSetupOptions object stores the settings that Abaqus uses when printing using a Windows printer. The PageSetupOptions object has no constructor. Abaqus creates the pageSetupOptions member when a session is started.

Notes

This object can be accessed by:

session.pageSetupOptions

Methods

setValues([imageSize, units, quality, ...])

This method modifies the PageSetupOptions object.

setValues(imageSize: SymbolicConstantType | float = 'FIT_TO_PAGE', units: SymbolicConstantType = 'INCHES', quality: SymbolicConstantType = 'MEDIUM', topMargin: float = 0, bottomMargin: float = 0, leftMargin: float = 0, rightMargin: float = 0, orientation: SymbolicConstantType = 'PORTRAIT', logo: BooleanType = 1, date: BooleanType = 1)[source]#

This method modifies the PageSetupOptions object.

Parameters:
imageSize

A SymbolicConstant or a pair of Floats specifying the size of the printed image in the currently selected units (inches or millimeters). Possible values are FIT_TO_PAGE and SIZE_ON_SCREEN. The default value is FIT_TO_PAGE.Note:The minimum value of width and height (minWidth and minHeight) is 10 mm (approximately 0.4 inches).

units

A SymbolicConstant specifying the units to use for the margins and image size. Possible values are INCHES and MM. The default value is INCHES.

quality

A SymbolicConstant specifying the quality of the image. Possible values are COARSE, MEDIUM, and FINE. The default value is MEDIUM.

topMargin

A Float specifying the top margin of the paper in the currently selected units (inches or millimeters). Possible values are topMargin ≥≥ 0. The default value is 0.5.

bottomMargin

A Float specifying the bottom margin of the paper in the currently selected units (inches or millimeters). Possible values are bottomMargin ≥≥ 0. The default value is 0.5.

leftMargin

A Float specifying the left margin of the paper in the currently selected units (inches or millimeters). Possible values are leftMargin ≥≥ 0. The default value is 0.5.

rightMargin

A Float specifying the right margin of the paper in the currently selected units (inches or millimeters). Possible values are rightMargin ≥≥ 0. The default value is 0.5.

orientation

A SymbolicConstant specifying the orientation of the image. Possible values are PORTRAIT and LANDSCAPE. The default value is PORTRAIT.

logo

A Boolean specifying whether the output includes the Abaqus logo. The default value is ON.

date

A Boolean specifying whether the output includes the date. The default value is ON.

Raises:
RangeError

Note:The minimum value of width and height (minWidth and minHeight) is 10 mm (approximately 0.4 inches). - If leftMargin + rightMargin is out of range:

RangeError: leftMargin and rightMargin must produce image width >= minWidth

  • If topMargin + bottomMargin is out of range: RangeError: topMargin and bottomMargin must produce image height >= minHeight

PngOptions#

class PngOptions[source]#

The PngOptions object stores the settings that Abaqus uses when printing in PNG format. The PngOptions object has no constructor. Abaqus creates the pngOptions member when a session is started.

Methods

cces()

session.pngOptions

setValues([imageSize])

This method modifies the PngOptions object.

cces()[source]#

session.pngOptions

Returns:
Raises:
setValues(imageSize: SymbolicConstantType = 'SIZE_ON_SCREEN')[source]#

This method modifies the PngOptions object.

Parameters:
imageSize

The SymbolicConstant SIZE_ON_SCREEN or a pair of Ints specifying the width and height of the image in pixels. Possible values are (minWidth, minHeight) ≤ imageSize ≤ (maxWidth and maxHeight). The default value is SIZE_ON_SCREEN. Note: The minimum value of width and height (minWidth and minHeight ) is the number of pixels that occupy 10 mm at the current screen resolution. The value is typically around 50 pixels and may be different for width and height. The maximum value of width and height (maxWidth and maxHeight ) is the largest number of pixels supported by the system graphics and will be at least as large as the screen dimensions.

Raises:
RangeError
  • If either the width or height arguments of imageSize are out of range (where

minWidth and minHeight are the number of pixels corresponding to approximately 10 mm for a given display and maxWidth and maxHeight are the largest allowable number of pixels supported by the system graphics):

RangeError: imageSize must be SIZE_ON_SCREEN or a sequence of 2 Ints in the range

(minWidth, minHeight) <= (width, height) <= (maxWidth, maxHeight).

PrintOptions#

class PrintOptions[source]#

The PrintOptions object stores the common settings that Abaqus uses for all print methods. The PrintOptions object has no constructor. Abaqus creates the printOptions member when a session is started.

Notes

This object can be accessed by:

session.printOptions

Methods

setValues([rendition, vpDecorations, ...])

This method modifies the PrintOptions object.

setValues(rendition: SymbolicConstantType = 'COLOR', vpDecorations: BooleanType = 1, vpBackground: BooleanType = 0, compass: BooleanType = 0, printCommand: str = '', deleteTemporaryFiles: BooleanType = 1, reduceColors: BooleanType = 0)[source]#

This method modifies the PrintOptions object.

Parameters:
rendition

A SymbolicConstant specifying how the image is rendered. Possible values are BLACK_AND_WHITE, GREYSCALE, and COLOR. The default value is COLOR.

vpDecorations

A Boolean specifying whether the output includes the viewport border and title. The default value is ON.

vpBackground

A Boolean specifying whether the output includes viewport backgrounds. The default value is OFF.

compass

A Boolean specifying whether the output includes the view compass The default value is OFF.

printCommand

A String specifying the default print command that will be used by the printToPrinter method if no printCommand argument is provided. The default value is “lpr”.

deleteTemporaryFiles

A Boolean specifying whether to delete the temporary files created when an image is printed. The default value is ON.You should set the deleteTemporaryFiles argument to False if your printer does not support print spooling.

reduceColors

A Boolean specifying whether the raster image printed is reduced from true color to 256 colors to reduce file size. The quality of the image will be compromised. The default value is OFF.

PsOptions#

class PsOptions[source]#

The PsOptions object stores the settings that Abaqus uses when printing using PostScript format. The PsOptions object has no constructor. Abaqus creates the psOptions member when a session is started.

Notes

This object can be accessed by:

session.psOptions

Methods

setValues([paperSize, topMargin, ...])

This method modifies the PsOptions object.

setValues(paperSize: SymbolicConstantType = 'LETTER', topMargin: float = 0, bottomMargin: float = 0, leftMargin: float = 0, rightMargin: float = 0, orientation: SymbolicConstantType = 'PORTRAIT', logo: BooleanType = 1, date: BooleanType = 1, resolution: SymbolicConstantType = 'DPI_150', fontType: SymbolicConstantType = 'PS_IF_AVAILABLE', imageFormat: SymbolicConstantType = 'VECTOR', shadingQuality: SymbolicConstantType = 'MEDIUM')[source]#

This method modifies the PsOptions object.

Parameters:
paperSize

A SymbolicConstant specifying the paper size. Possible values are:

  • LETTER

  • LEGAL

  • LEDGER

  • A0

  • A1

  • A2

  • A3

  • A4

  • A5

The default value is LETTER.

topMargin

A Float specifying the top margin of the paper in inches. Possible values are topMargin ≥≥ 0. The default value is 0.5.

bottomMargin

A Float specifying the bottom margin of the paper in inches. Possible values are bottomMargin ≥≥ 0. The default value is 0.5.

leftMargin

A Float specifying the left margin of the paper in inches. Possible values are leftMargin ≥≥ 0. The default value is 0.5.

rightMargin

A Float specifying the right margin of the paper in inches. Possible values are rightMargin ≥≥ 0. The default value is 0.5.

orientation

A SymbolicConstant specifying the orientation of the image. Possible values are PORTRAIT and LANDSCAPE. The default value is PORTRAIT.

logo

A Boolean specifying whether the output includes the Abaqus logo. The default value is ON.

date

A Boolean specifying whether the output includes the date. The default value is ON.

resolution

A SymbolicConstant specifying the resolution of the image in dots per inch (dpi). The resolution can be DPI_1200 only if imageFormat = VECTOR. Possible values are DPI_75, DPI_150, DPI_300, DPI_450, DPI_600, and DPI_1200. The default value is DPI_150.

fontType

A SymbolicConstant specifying the PostScript font substitution rules to be applied. Possible values are PS_ALWAYS, PS_IF_AVAILABLE, and AS_DISPLAYED. The default value is PS_IF_AVAILABLE.

imageFormat

A SymbolicConstant specifying how the viewport display will be represented. Possible values are VECTOR and RASTER. The default value is VECTOR.

shadingQuality

A SymbolicConstant specifying how fine the shading of curved surfaces will be for vector images. Possible values are EXTRA COARSE, COARSE, MEDIUM, FINE, and EXTRA FINE. The default value is MEDIUM.

Raises:
RangeError

Note:The minimum value of width and height (minWidth and minHeight) is 10 mm (approximately 0.4 inches). - If leftMargin + rightMargin is out of range:

RangeError: leftMargin and rightMargin must produce image width >= minWidth

  • If topMargin + bottomMargin is out of range: RangeError: topMargin and bottomMargin must produce image height >= minHeight

SvgOptions#

class SvgOptions[source]#

The SvgOptions object stores the settings that Abaqus uses when printing in SVG format. The SvgOptions object has no constructor. Abaqus creates the svgOptions member when a session is started.

Notes

This object can be accessed by:

session.svgOptions

Methods

setValues([imageSize])

This method modifies the SvgOptions object.

setValues(imageSize: SymbolicConstantType = 'SIZE_ON_SCREEN')[source]#

This method modifies the SvgOptions object.

Parameters:
imageSize

The SymbolicConstant SIZE_ON_SCREEN or a pair of Ints specifying the width and height of the image in pixels. Possible values are (minWidth, minHeight ) ≤≤ imageSize ≤≤ (maxWidth and maxHeight). The default value is SIZE_ON_SCREEN.Note:The minimum value of width and height (minWidth and minHeight) is the number of pixels that occupy 10 mm at the current screen resolution. The value is typically around 50 pixels and may be different for width and height.The maximum value of width and height (maxWidth and maxHeight) is the largest number of pixels supported by the system graphics and will be at least as large as the screen dimensions.

Raises:
RangeError
  • If either the width or height arguments of imageSize are out of range (where

minWidth and minHeight are the number of pixels corresponding to approximately 10 mm for a given display and maxWidth and maxHeight are the largest allowable number of pixels supported by the system graphics):

RangeError: imageSize must be SIZE_ON_SCREEN or a sequence of 2 Ints in the range

(minWidth, minHeight) <= (width, height) <= (maxWidth, maxHeight).