get_shape_renderer method

get_shape_renderer()

Creates and returns an object that can be used to render this shape into an image.

def get_shape_renderer(self):
    ...

Remarks

This method just invokes the ShapeRenderer constructor and passes this object as a parameter.

Returns

The renderer object for this shape.

Examples

Shows how to use a shape renderer to export shapes to files in the local file system.

doc = aw.Document(MY_DIR + 'Various shapes.docx')
shapes = [node.as_shape() for node in doc.get_child_nodes(aw.NodeType.SHAPE, True)]
self.assertEqual(7, len(shapes))
# There are 7 shapes in the document, including one group shape with 2 child shapes.
# We will render every shape to an image file in the local file system
# while ignoring the group shapes since they have no appearance.
# This will produce 6 image files.
for shape in doc.get_child_nodes(aw.NodeType.SHAPE, True):
    shape = shape.as_shape()
    renderer = shape.get_shape_renderer()
    options = aw.saving.ImageSaveOptions(aw.SaveFormat.PNG)
    renderer.save(ARTIFACTS_DIR + 'Shape.render_all_shapes.' + shape.name + '.png', options)

See Also

• module aspose.words.drawing
• class ShapeBase