# Manage Presentation Ink Objects in JavaScript

> Manage PowerPoint ink objects, edit traces and brush properties, and control ink appearance during PDF, HTML, SVG, TIFF, and image export with Aspose.Slides for Node.js via Java.

Source: https://docs.aspose.com/slides/nodejs-java/manage-ink/
Updated: 2026-08-10


## **Introduction**

PowerPoint provides an ink feature that allows you to draw freeform strokes. Ink can be used to highlight other objects, show connections and processes, and draw attention to specific items on a slide.

Aspose.Slides provides the types needed to work with ink objects. For example, the [Ink](https://reference.aspose.com/slides/nodejs-java/aspose.slides/ink/) class represents an ink object on a slide.

## **Differences between Regular Objects and Ink Objects**

Objects on a PowerPoint slide are typically represented by shape objects. In its simplest form, a shape is a container that defines the area of the object itself (its frame) along with properties such as the container size, shape, and background. For more information, see [Shape Layout Format](https://docs.aspose.com/slides/nodejs-java/shape-manipulations/#access-layout-formats-for-shape).

However, when PowerPoint handles an ink object, it ignores all properties of the object frame (container) except its size. The size of the container area is determined by the standard [Shape.getWidth](https://reference.aspose.com/slides/nodejs-java/aspose.slides/shape/#getWidth--) and [Shape.getHeight](https://reference.aspose.com/slides/nodejs-java/aspose.slides/shape/#getHeight--) methods:

![ink_powerpoint1](ink_powerpoint1.png)

## **Ink Traces**

An ink trace is a basic element used to record the trajectory of a pen as a user writes digital ink. A trace stores a sequence of connected points.

The simplest form of encoding specifies the X and Y coordinates of each sample point. When all connected points are rendered, they produce an image like this:

![ink_powerpoint2](ink_powerpoint2.png)

## **Brush Properties for Drawing**

A brush is used to draw lines that connect the points of an ink trace. The brush has its own color and size, represented by the [InkBrush.getColor](https://reference.aspose.com/slides/nodejs-java/aspose.slides/inkbrush/#getColor--) and [InkBrush.getSize](https://reference.aspose.com/slides/nodejs-java/aspose.slides/inkbrush/#getSize--) methods.

### **Set Ink Brush Color**

This JavaScript code shows how to set the color of an ink brush:

```javascript
const aspose = {
    slides: require("aspose.slides.via.java")
};
const java = require("java");

const presentation = new aspose.slides.Presentation("pres.pptx");
try {
    const slide = presentation.getSlides().get_Item(0);
    const ink = slide.getShapes().get_Item(0);
    const brush = ink.getTraces()[0].getBrush();
    const red = java.getStaticFieldValue("java.awt.Color", "RED");
    brush.setColor(red);
} finally {
    presentation.dispose();
}
```

### **Set Ink Brush Size**

This JavaScript code shows how to set the size of an ink brush:

```javascript
const aspose = {
    slides: require("aspose.slides.via.java")
};
const java = require("java");

const presentation = new aspose.slides.Presentation("pres.pptx");
try {
    const slide = presentation.getSlides().get_Item(0);
    const ink = slide.getShapes().get_Item(0);
    const brush = ink.getTraces()[0].getBrush();
    const brushSize = java.newInstanceSync("java.awt.Dimension", 5, 10);
    brush.setSize(brushSize);
} finally {
    presentation.dispose();
}
```

Generally, a brush's width and height do not match, so PowerPoint does not display the brush size (the corresponding data section is grayed out). When the brush width and height match, PowerPoint displays its size this way:

![ink_powerpoint3](ink_powerpoint3.png)

For clarity, let's increase the height of the ink object and review the important dimensions:

![ink_powerpoint4](ink_powerpoint4.png)

The container (frame) does not account for the size of the brushes—it always assumes that the line thickness is zero (see the previous image).

Therefore, to determine the visible area of the entire ink object, the brush size of its traces must be taken into account. Here, the target object (the handwritten text trace) has been scaled to the size of the container (frame). When the size of the container changes, the brush size remains constant, and vice versa.

![ink_powerpoint5](ink_powerpoint5.png)

PowerPoint uses similar behavior for text objects:

![ink_powerpoint6](ink_powerpoint6.png)

## **Control Ink Appearance During Export and Rendering**

Aspose.Slides provides the [InkOptions](https://reference.aspose.com/slides/nodejs-java/aspose.slides/inkoptions/) class to control how ink objects appear in exported or rendered output. You can use its properties to hide ink completely or change how ink brush mask operations are interpreted.

Ink options are available through the export or rendering options for several output types:

| Output | Ink options property |
| --- | --- |
| PDF | [`PdfOptions.getInkOptions`](https://reference.aspose.com/slides/nodejs-java/aspose.slides/pdfoptions/#getInkOptions--) |
| HTML | [`HtmlOptions.getInkOptions`](https://reference.aspose.com/slides/nodejs-java/aspose.slides/htmloptions/#getInkOptions--) |
| SVG | [`SVGOptions.getInkOptions`](https://reference.aspose.com/slides/nodejs-java/aspose.slides/svgoptions/#getInkOptions--) |
| TIFF | [`TiffOptions.getInkOptions`](https://reference.aspose.com/slides/nodejs-java/aspose.slides/tiffoptions/#getInkOptions--) |
| Slide image | [`RenderingOptions.getInkOptions`](https://reference.aspose.com/slides/nodejs-java/aspose.slides/renderingoptions/#getInkOptions--) |

The following [InkOptions](https://reference.aspose.com/slides/nodejs-java/aspose.slides/inkoptions/) methods expose the same two settings:

- [InkOptions.getHideInk](https://reference.aspose.com/slides/nodejs-java/aspose.slides/inkoptions/#getHideInk--) determines whether ink objects are included in the output. Its default value is `false`.
- [InkOptions.getInterpretMaskOpAsOpacity](https://reference.aspose.com/slides/nodejs-java/aspose.slides/inkoptions/#getInterpretMaskOpAsOpacity--) determines whether a mask operation is interpreted as opacity when rendering an ink brush. Its default value is `true`; call [InkOptions.setInterpretMaskOpAsOpacity](https://reference.aspose.com/slides/nodejs-java/aspose.slides/inkoptions/#setInterpretMaskOpAsOpacity-boolean-) with `false` to use the ROP operation instead.

### **Hide Ink Objects in PDF Output**

By default, ink objects remain visible during export. To create a clean output without handwritten annotations or other ink content, call [InkOptions.setHideInk](https://reference.aspose.com/slides/nodejs-java/aspose.slides/inkoptions/#setHideInk-boolean-) with `true`.

The following JavaScript example exports a presentation to PDF while hiding all ink objects:

```javascript
const aspose = {
    slides: require("aspose.slides.via.java")
};

const presentation = new aspose.slides.Presentation("presentation.pptx");
try {
    const pdfOptions = new aspose.slides.PdfOptions();
    pdfOptions.getInkOptions().setHideInk(true);

    presentation.save("presentation_without_ink.pdf", aspose.slides.SaveFormat.Pdf, pdfOptions);
} finally {
    presentation.dispose();
}
```

### **Hide Ink Objects When Rendering a Slide as an Image**

To hide ink objects when rendering slides as bitmap images, configure [RenderingOptions.getInkOptions](https://reference.aspose.com/slides/nodejs-java/aspose.slides/renderingoptions/#getInkOptions--) and pass the rendering options to [Slide.getImage](https://reference.aspose.com/slides/nodejs-java/aspose.slides/slide/#getImage-aspose.slides.IRenderingOptions-).

The following JavaScript example renders the first slide as a PNG image without ink objects:

```javascript
const aspose = {
    slides: require("aspose.slides.via.java")
};

const presentation = new aspose.slides.Presentation("presentation.pptx");
try {
    const renderingOptions = new aspose.slides.RenderingOptions();
    renderingOptions.getInkOptions().setHideInk(true);

    const slide = presentation.getSlides().get_Item(0);
    const image = slide.getImage(renderingOptions);
    try {
        image.save("slide_without_ink.png", aspose.slides.ImageFormat.Png);
    } finally {
        image.dispose();
    }
} finally {
    presentation.dispose();
}
```

### **Control Ink Mask Rendering**

The [InkOptions.getInterpretMaskOpAsOpacity](https://reference.aspose.com/slides/nodejs-java/aspose.slides/inkoptions/#getInterpretMaskOpAsOpacity--) setting controls how mask operations are interpreted when rendering ink brushes. The default value is `true`, which uses opacity. To use the ROP operation instead, call [InkOptions.setInterpretMaskOpAsOpacity](https://reference.aspose.com/slides/nodejs-java/aspose.slides/inkoptions/#setInterpretMaskOpAsOpacity-boolean-) with `false`.

The following JavaScript example exports a slide to SVG and uses ROP-based rendering for ink mask operations:

```javascript
const aspose = {
    slides: require("aspose.slides.via.java")
};
const java = require("java");

const presentation = new aspose.slides.Presentation("presentation.pptx");
try {
    const svgOptions = new aspose.slides.SVGOptions();
    svgOptions.getInkOptions().setInterpretMaskOpAsOpacity(false);

    const outputStream = java.newInstanceSync("java.io.FileOutputStream", "slide.svg");
    try {
        const slide = presentation.getSlides().get_Item(0);
        slide.writeAsSvg(outputStream, svgOptions);
    } finally {
        outputStream.close();
    }
} finally {
    presentation.dispose();
}
```

The same setting can be applied through [TiffOptions.getInkOptions](https://reference.aspose.com/slides/nodejs-java/aspose.slides/tiffoptions/#getInkOptions--) when exporting a presentation or rendering a slide to TIFF.

### **Choose Whether to Hide or Preserve Ink**

When you need a clean version of an annotated presentation for distribution without review marks, call [InkOptions.setHideInk](https://reference.aspose.com/slides/nodejs-java/aspose.slides/inkoptions/#setHideInk-boolean-) with `true` during export.

Leave [InkOptions.getHideInk](https://reference.aspose.com/slides/nodejs-java/aspose.slides/inkoptions/#getHideInk--) at its default value of `false` when ink annotations are part of the intended content, such as review comments, handwritten notes, highlights, or drawings that should remain visible in the exported result. This allows applications to generate separate review and final outputs from the same presentation without modifying the source ink objects.

## **FAQ**

**Can I change the color or size of an existing ink stroke?**

Yes. Get the trace from [Ink.getTraces](https://reference.aspose.com/slides/nodejs-java/aspose.slides/ink/#getTraces--) and then change its [InkTrace.getBrush](https://reference.aspose.com/slides/nodejs-java/aspose.slides/inktrace/#getBrush--). Call [InkBrush.setColor](https://reference.aspose.com/slides/nodejs-java/aspose.slides/inkbrush/#setColor-java.awt.Color-) or [InkBrush.setSize](https://reference.aspose.com/slides/nodejs-java/aspose.slides/inkbrush/#setSize-java.awt.geom.Dimension2D-) to change the brush.

**Does hiding ink change the source presentation?**

No. Calling [InkOptions.setHideInk](https://reference.aspose.com/slides/nodejs-java/aspose.slides/inkoptions/#setHideInk-boolean-) affects only the rendered or exported result; it does not remove or modify ink objects in the source presentation.

**Which export formats support ink options?**

You can configure ink options for PDF, HTML, SVG, TIFF, and bitmap slide images through the corresponding export or rendering options shown above.

**Further reading**

* To read about shapes in general, see the [PowerPoint Shapes](https://docs.aspose.com/slides/nodejs-java/powerpoint-shapes/) section.
* For more information on effective values, see [Shape Effective Properties](https://docs.aspose.com/slides/nodejs-java/shape-effective-properties/#get-effective-font-height-value).
* For details on PDF export, see [Convert PPT and PPTX to PDF](https://docs.aspose.com/slides/nodejs-java/convert-powerpoint-to-pdf/).
* For details on HTML export, see [Convert PowerPoint Presentations to HTML](https://docs.aspose.com/slides/nodejs-java/convert-powerpoint-to-html/).
* For details on SVG export, see [Render Presentation Slides as SVG Images](https://docs.aspose.com/slides/nodejs-java/render-a-slide-as-an-svg-image/).
* For details on TIFF export, see [Convert PowerPoint Presentations to TIFF](https://docs.aspose.com/slides/nodejs-java/convert-powerpoint-to-tiff/).
* For details on slide-to-image rendering, see [Convert Presentation Slides to Images](https://docs.aspose.com/slides/nodejs-java/convert-slide/).