Package com.inet.report
Interface PictureProperties
- All Known Implementing Classes:
AbstractPictureElement
,DatabasePicture
,Picture
public interface PictureProperties
Interface for elements that display pictures.
This class is part of the RDC.
This class is part of the RDC.
- Since:
- 6.5
-
Field Summary
Modifier and TypeFieldDescriptionstatic final int
The vertical alignment will be bottom aligned.static final int
The vertical alignment will be centered.static final int
The vertical alignment will be top aligned.static final int
Scales the source image to fit in the bounds of its element size while keeping the correct aspect ratio.static final int
Scales the height of the source image to its element size while keeping the correct aspect ratio.static final int
Stretches the source image to the element framestatic final int
Scales the width of the source image to its element size and the height using the given scale factor.static final int
Scales the width of the source image to its element size while keeping the correct aspect ratio.static final int
Scales the width of the source image by the given scaling factor and scales its height to the height of the element.static final int
Scales the source image by the given scaling factor -
Method Summary
Modifier and TypeMethodDescription@Nullable com.inet.report.encode.PictureMetaData
Creates a meta data instance for this picture.int
Gets the value of the property 'bottom cropping size'.Returns the formula of the property 'can grow'.Returns the formula of the property 'can shrink'.int
Gets the height of an element.double
Gets the property 'height rendering factor'.double
Gets the property 'height scaling factor'.int
Returns the value of the property 'horizontal alignment'.Returns the formula for the property 'horizontal alignment'.Return the image key formula for this picture.int
Gets the value of the property 'left cropping size'.int
Gets the value of the property 'right cropping size'.int
Gets the scaling option which represents the way to scale the source image into its element frame.int
Gets the value of the property 'top cropping size'.int
Returns the value of the property 'vertical alignment'.Gets the formula for the property 'vertical alignment'.int
getWidth()
Gets the width of an element.double
Gets the property 'width rendering factor'.double
Gets the property 'width scaling factor'.boolean
Returns the value of the property 'can grow'.boolean
Returns the value of the property 'can shrink'.void
setBottomCropping
(int bottomCropping) Sets the value of the property 'bottom cropping size'.void
setCanGrow
(boolean canGrow) Sets the value of the property 'can grow'.void
setCanGrowFormula
(FormulaField newFormula) Sets the formula for the property 'can grow'.void
setCanShrink
(boolean canShrink) Sets the value of the property 'can shrink'.void
setCanShrinkFormula
(FormulaField newFormula) Sets the formula for the property 'can shrink'.void
setHeight
(int height) Sets the height of an element.void
setHeightScalingFactor
(double factor) Sets the property 'height scaling factor'.void
setHorAlign
(int value) Sets the value of the property 'horizontal alignment'.void
setHorAlignFormula
(FormulaField newFormula) Sets the formula for the property 'horizontal alignment'.void
setImageKeyFormula
(FormulaField newFormula) Sets a Formulafield which contains a key string to identify identical images.void
setLeftCropping
(int leftCropping) Sets the value of the property 'left cropping size'.void
setRightCropping
(int rightCropping) Sets the value of the property 'right cropping size'.void
setScalingOption
(int option) Sets the scaling option which represents the way to scale the source image into its element frame.void
setTopCropping
(int topCropping) Sets the value of the property 'top cropping size'.void
setVerAlign
(int value) Sets the value of the property 'vertical alignment'.void
setVerAlignFormula
(FormulaField newFormula) Sets the formula for the property 'vertical alignment'.void
setWidth
(int width) Sets the width of an element.void
setWidthScalingFactor
(double factor) Sets the property 'width scaling factor'.
-
Field Details
-
ALIGN_VERTICAL_TOP
static final int ALIGN_VERTICAL_TOPThe vertical alignment will be top aligned.- Since:
- 7.0
- See Also:
-
ALIGN_VERTICAL_CENTER
static final int ALIGN_VERTICAL_CENTERThe vertical alignment will be centered.- Since:
- 7.0
- See Also:
-
ALIGN_VERTICAL_BOTTOM
static final int ALIGN_VERTICAL_BOTTOMThe vertical alignment will be bottom aligned.- Since:
- 7.0
- See Also:
-
SCALE_FIT_WIDTH_FIT_HEIGHT
static final int SCALE_FIT_WIDTH_FIT_HEIGHTStretches the source image to the element frame- See Also:
-
SCALE_FIXED_WIDTH_FIXED_HEIGHT
static final int SCALE_FIXED_WIDTH_FIXED_HEIGHTScales the source image by the given scaling factor- See Also:
-
SCALE_FIT_WIDTH_FIXED_HEIGHT
static final int SCALE_FIT_WIDTH_FIXED_HEIGHTScales the width of the source image to its element size and the height using the given scale factor.- See Also:
-
SCALE_FIXED_WIDTH_FIT_HEIGHT
static final int SCALE_FIXED_WIDTH_FIT_HEIGHTScales the width of the source image by the given scaling factor and scales its height to the height of the element.- See Also:
-
SCALE_FIT_WIDTH_KEEP_ASPECT_RATIO
static final int SCALE_FIT_WIDTH_KEEP_ASPECT_RATIOScales the width of the source image to its element size while keeping the correct aspect ratio.- See Also:
-
SCALE_FIT_HEIGHT_KEEP_ASPECT_RATIO
static final int SCALE_FIT_HEIGHT_KEEP_ASPECT_RATIOScales the height of the source image to its element size while keeping the correct aspect ratio.- See Also:
-
SCALE_BEST_FIT_KEEP_ASPECT_RATIO
static final int SCALE_BEST_FIT_KEEP_ASPECT_RATIOScales the source image to fit in the bounds of its element size while keeping the correct aspect ratio.- See Also:
-
-
Method Details
-
setBottomCropping
void setBottomCropping(int bottomCropping) Sets the value of the property 'bottom cropping size'.- Parameters:
bottomCropping
- The long value of the property 'bottom cropping size'.- Since:
- 6.0
-
getBottomCropping
int getBottomCropping()Gets the value of the property 'bottom cropping size'.- Returns:
- The long value of the property 'bottom cropping size'.
- Since:
- 6.0
-
setLeftCropping
void setLeftCropping(int leftCropping) Sets the value of the property 'left cropping size'.- Parameters:
leftCropping
- The value of the property 'left cropping size'.- Since:
- 6.0
-
getLeftCropping
int getLeftCropping()Gets the value of the property 'left cropping size'.- Returns:
- The value of the property 'left cropping size'.
- Since:
- 6.0
-
setRightCropping
void setRightCropping(int rightCropping) Sets the value of the property 'right cropping size'.- Parameters:
rightCropping
- The long value of the property 'right cropping size'.- Since:
- 6.0
-
getRightCropping
int getRightCropping()Gets the value of the property 'right cropping size'.- Returns:
- The value of the property 'right cropping size'.
- Since:
- 6.0
-
setTopCropping
void setTopCropping(int topCropping) Sets the value of the property 'top cropping size'.- Parameters:
topCropping
- The value of the property 'top cropping size'.- Since:
- 6.0
-
getTopCropping
int getTopCropping()Gets the value of the property 'top cropping size'.- Returns:
- The long value of the property 'top cropping size'.
- Since:
- 6.0
-
getScalingOption
int getScalingOption()Gets the scaling option which represents the way to scale the source image into its element frame. E.g.SCALE_FIT_WIDTH_FIXED_HEIGHT
will scale the width of source image to the width of the element and the height by the given scale factor set using thesetHeightScalingFactor(double)
.- Returns:
- An integer values which represents the scale option.
- Since:
- 6.0
- See Also:
-
setScalingOption
void setScalingOption(int option) Sets the scaling option which represents the way to scale the source image into its element frame. E.g.SCALE_FIT_WIDTH_FIXED_HEIGHT
will scale the width of source image to the width of the element and the height by the given scale factor set using thesetHeightScalingFactor(double)
.- Parameters:
option
- An integer, which represents the scaling option.- Since:
- 6.0
- See Also:
-
getWidthScalingFactor
double getWidthScalingFactor()Gets the property 'width scaling factor'.- Returns:
- The value of the property 'width scaling factor'. I.e. 0.1 means 10%, 1.0 5.0 means 500%.
- Since:
- 6.0
-
setWidthScalingFactor
void setWidthScalingFactor(double factor) Sets the property 'width scaling factor'.- Parameters:
factor
- The value of the property 'width scaling factor'. I.e. 0.1 means 10%, 5.0 means 500%.- Since:
- 6.0
-
setHeightScalingFactor
void setHeightScalingFactor(double factor) Sets the property 'height scaling factor'.- Parameters:
factor
- The value of the property 'height scaling factor'. I.e. 0.1 means 10%, 5.0 means 500%.- Since:
- 6.0
-
getHeightScalingFactor
double getHeightScalingFactor()Gets the property 'height scaling factor'.- Returns:
- The value of the property 'height scaling factor'. I.e. 0.1 means 10%, 5.0 means 500%.
- Since:
- 6.0
-
getWidthRenderingFactor
double getWidthRenderingFactor()Gets the property 'width rendering factor'. While 'width scaling factor' is a user defined faction this rendering factor includes the user factor and the image resolution if available. Otherwise it is equal to width scaling factor- Returns:
- The value of the property 'width scaling factor'. I.e. 0.1 means 10%, 5.0 means 500%.
- Since:
- 8.2
-
getHeightRenderingFactor
double getHeightRenderingFactor()Gets the property 'height rendering factor'. While 'height scaling factor' is a user defined factor, this rendering factor includes the user factor and the image resolution if available. Otherwise it is equal to height scaling factor.- Returns:
- The value of the property 'height scaling factor'. I.e. 0.1 means 10%, 5.0 means 500%.
- Since:
- 8.2
-
getVerAlignFormula
FormulaField getVerAlignFormula()Gets the formula for the property 'vertical alignment'. Possible alignments are default, top, center, or bottom.- Returns:
- The formula for the property 'vertical alignment'.
- Since:
- 6.0
- See Also:
-
setVerAlignFormula
Sets the formula for the property 'vertical alignment'. Possible alignments are default, top, center, or bottom.- Parameters:
newFormula
- The new formula for the property 'horizontal alignment'.- Since:
- 6.0
- See Also:
-
setVerAlign
void setVerAlign(int value) Sets the value of the property 'vertical alignment'. Possible alignments are default, left, center, right or justified.- Parameters:
value
- The new value of the property 'vertical alignment'.- Since:
- 6.0
- See Also:
-
getVerAlign
int getVerAlign()Returns the value of the property 'vertical alignment'. Possible alignments are default, left, center, right or justified.- Returns:
- the 'vertical alignment' property of this element.
- Since:
- 6.0
- See Also:
-
isCanShrink
boolean isCanShrink()Returns the value of the property 'can shrink'. If this property is enabled an element with dynamic state will be shrunk when the content of the element is smaller than its container.- Returns:
- The value of the property 'can shrink'.
- Since:
- 7.0
-
setCanShrink
void setCanShrink(boolean canShrink) Sets the value of the property 'can shrink'. If this property is enabled an element with dynamic state will be shrunk when the content of the element is smaller than its container.- Parameters:
canShrink
- If true shrinking to the image size is allowed.- Since:
- 6.0
-
getCanShrinkFormula
FormulaField getCanShrinkFormula()Returns the formula of the property 'can shrink'. If this property is enabled an element with dynamic state will be shrunk dynamically when the content of the element is larger than its container.- Returns:
FormulaField
The formula of the property 'can grow'.- Since:
- 6.0
-
setCanShrinkFormula
Sets the formula for the property 'can shrink'. If this property is enabled an element with dynamic state will be shrunk dynamically when then content of the element is larger than its container.- Parameters:
newFormula
- The new formula for the property 'can grow'.- Since:
- 6.0
-
setWidth
void setWidth(int width) Sets the width of an element. The unit is in twips.- Parameters:
width
- The width in twips.- Since:
- 7.0
-
getWidth
int getWidth()Gets the width of an element. Use the 'element width' property to change the width of the element. The unit is in twips.- Returns:
- The width in twips.
- Throws:
UnsupportedOperationException
- if this element spans multiple sections- Since:
- 7.0
-
setHeight
void setHeight(int height) Sets the height of an element. Use the 'element height' property to change the height of the element. The unit is in twips.- Parameters:
height
- The height in twips.- Throws:
UnsupportedOperationException
- if this element spans multiple sections- Since:
- 7.0
-
getHeight
int getHeight()Gets the height of an element. Use the 'element height' property to change the height of the element. The unit is in twips.- Returns:
- The height in twips.
- Throws:
UnsupportedOperationException
- if this element spans multiple sections- Since:
- 7.0
-
isCanGrow
boolean isCanGrow()Returns the value of the property 'can grow'. If this property is enabled, an element with dynamic state will be expanded vertically if its content is larger than its container. If this property is disabled the content will be truncated when its size is larger than the container.- Returns:
- The value of the property 'can grow'.
- Since:
- 7.0
-
setCanGrow
void setCanGrow(boolean canGrow) Sets the value of the property 'can grow'. If this property is enabled, an element with dynamic state will be expanded vertically if its content is larger than its container. If this property is disabled the content will be truncated when its size is larger than the container.- Parameters:
canGrow
- The new value of the property 'can grow'- Since:
- 7.0
-
getCanGrowFormula
FormulaField getCanGrowFormula()Returns the formula of the property 'can grow'. If this property is enabled, an element with dynamic state will be expanded vertically if its content is larger than its container. If this property is disabled the content will be truncated when its size is larger than the container.- Returns:
- FormulaField The formula of the property 'can grow'.
- Since:
- 7.0
-
setCanGrowFormula
Sets the formula for the property 'can grow'. If this property is enabled, an element with dynamic state will be expanded vertically if its content is larger than its container. If this property is disabled the content will be truncated when its size is larger than the container.- Parameters:
newFormula
- The new formula for the property 'can grow'.- Since:
- 7.0
-
getHorAlignFormula
FormulaField getHorAlignFormula()Returns the formula for the property 'horizontal alignment'. Possible alignments are default, left, center, right or justified.- Returns:
- FormulaField The formula for the property 'horizontal alignment'.
- Since:
- 7.0
-
setHorAlignFormula
Sets the formula for the property 'horizontal alignment'. Possible alignments are default, left, center, right or justified.- Parameters:
newFormula
- The new formula for the property 'horizontal alignment'. The result of the formula should be in range from 0 to 4.- Since:
- 7.0
- See Also:
-
setHorAlign
void setHorAlign(int value) Sets the value of the property 'horizontal alignment'. Possible alignments are default, left, center, right or justified.- Parameters:
value
- The new value of the property 'horizontal alignment'.- Since:
- 7.0
- See Also:
-
getHorAlign
int getHorAlign()Returns the value of the property 'horizontal alignment'. Possible alignments are default, left, center, right or justified.- Returns:
- Possible return values are default, left, center, right or justified.
- Since:
- 7.0
- See Also:
-
setImageKeyFormula
Sets a Formulafield which contains a key string to identify identical images. Renderers which are using a cache mechanism (e.g. PDF) can use this key to optimize its rendering and memory performance. Picture Objects with the same key will be treated as the picture objects with the same image.- Parameters:
newFormula
- the formula containing the image key.- Since:
- 9.2
-
getImageKeyFormula
FormulaField getImageKeyFormula()Return the image key formula for this picture. Renderers which are using a cache mechanism (e.g. PDF) can use this key to optimize its rendering and memory performance. Picture Objects with the same key will be treated as the picture objects with the same image.- Returns:
- Return the image key formula for this picture.
- Since:
- 9.2
-
createPictureMetaData
@Nullable @Nullable com.inet.report.encode.PictureMetaData createPictureMetaData()Creates a meta data instance for this picture.- Returns:
- the created meta data instance or
null
if no meta data can be retrieved (e.g. when picture data is missing or the data format is unknown) - Since:
- 12.1
-