> For the complete documentation index, see [llms.txt](https://docs.apryse.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.apryse.com/core/pdf-editing/write.md).

# Write page content to PDF on Server/Desktop

Learn how to write and embed elements in PDF pages with the PDFNet page writing API. Copy graphical elements, embed fonts, and more. Full code samples included! The Apryse Server SDK streamlines secur

To write page content to a new document.

{% tabs %}
{% tab title="C#" %}
{% code lineNumbers="true" %}

```csharp
PDFDoc doc = new PDFDoc();

// ElementBuilder is used to build new Element objects
ElementBuilder builder = new ElementBuilder(); 

// ElementWriter is used to write Elements to the page
ElementWriter writer = new ElementWriter(); 

// Start a new page
Page page = doc.PageCreate();

// Begin writing to this page
writer.Begin(page);  

// Create an Image that can be reused multiple times in the document or multiple on the same page.
MappedFile img_file = new MappedFile(imagename);
FilterReader img_data = new FilterReader(img_file);
Image img = Image.Create(doc, img_data, 400, 600, 8, ColorSpace.CreateDeviceRGB(), Image.InputFilter.e_jpeg);
Element element = builder.CreateImage(img, new Matrix2D(200, -145, 20, 300, 200, 150));
writer.WritePlacedElement(element);

// Use the same image (just change its matrix)
GState gstate = element.GetGState();
gstate.SetTransform(200, 0, 0, 300, 50, 450);
writer.WritePlacedElement(element);

// Use the same image (just change its matrix)
writer.WritePlacedElement(builder.CreateImage(img, 300, 600, 200, -150));

// save changes to the current page
writer.End();  

// Add the new page to the document sequence
doc.PagePushBack(page);
```

{% endcode %}
{% endtab %}

{% tab title="C++" %}
{% code lineNumbers="true" %}

```cpp
PDFDoc doc;

// ElementBuilder is used to build new Element objects
ElementBuilder builder;

// ElementWriter is used to write Elements to the page
ElementWriter writer;		

// Start a new page
Page page = doc.PageCreate(Rect(0, 0, 612, 794));

// begin writing to the page
writer.Begin(page);	

// Create an Image that can be reused multiple times in the document or multiple on the same page.		
Image img = Image::Create(doc, imagename);
Element element = builder.CreateImage(img, Common::Matrix2D(200, -145, 20, 300, 200, 150));
writer.WritePlacedElement(element);

// use the same image again (just change its matrix).
Gstate gstate = element.GetGState();
gstate.SetTransform(200, 0, 0, 300, 50, 450);
writer.WritePlacedElement(element);

// use the same image again (just change its matrix).
writer.WritePlacedElement(builder.CreateImage(img, 300, 600, 200, -150));

// save changes to the current page
writer.End();

// Add the new page to the document sequence
doc.PagePushBack(page);
```

{% endcode %}
{% endtab %}

{% tab title="Go" %}
{% code lineNumbers="true" %}

```go
doc := NewPDFDoc(filename)

// ElementBuilder is used to build new Element objects
builder := NewElementBuilder()

// ElementWriter is used to write Elements to the page
writer := NewElementWriter()

// Start a new page
page = doc.PageCreate(NewRect(0, 0, 612.0, 794.0))

// begin writing to the page
writer.Begin(page);	

// Create an Image that can be reused multiple times in the document or multiple on the same page.		
img := ImageCreate(doc, imagename)
element := builder.CreateImage(img, NewMatrix2D(100.0, 0.0, 0.0, 100.0, 300.0, 500.0))
writer.WritePlacedElement(element)

// use the same image again (just change its matrix).
gstate := element.GetGState()
gstate.SetTransform(200.0, 0.0, 0.0, 300.0, 50.0, 450.0)
writer.WritePlacedElement(element);

// use the same image again (just change its matrix).
writer.WritePlacedElement(eb.CreateImage(img, 300.0, 600.0, 200.0, -150.0))

// save changes to the current page
writer.End()

// Add the new page to the document sequence
doc.PagePushBack(page)
```

{% endcode %}
{% endtab %}

{% tab title="Java" %}
{% code lineNumbers="true" %}

```java
PDFDoc doc = new PDFDoc();

// ElementBuilder is used to build new Element objects
ElementBuilder eb = new ElementBuilder();        

// ElementWriter is used to write Elements to the page
ElementWriter writer = new ElementWriter();

// Start a new page
Page page = doc.pageCreate();

// begin writing to the page
writer.begin(page);    

// Create an Image that can be reused multiple times in the document or multiple on the same page.
Image img = Image.create(doc.getSDFDoc(), imagename);
Element element = eb.createImage(img, new Matrix2D(200, -145, 20, 300, 200, 150));
writer.writePlacedElement(element);

// use the same image again (just change its matrix).
Gstate gstate = element.getGState();
gstate.setTransform(200, 0, 0, 300, 50, 450);
writer.writePlacedElement(element);

// use the same image again (just change its matrix).
writer.writePlacedElement(eb.createImage(img, 300, 600, 200, -150));

// save changes to the current page
writer.end();

// Add the new page to the document sequence
doc.pagePushBack(page);
```

{% endcode %}
{% endtab %}

{% tab title="JavaScript" %}
{% code lineNumbers="true" %}

```js
async function main() {
  const doc = await PDFNet.PDFDoc.create();

  // ElementBuilder is used to build new Element objects
  const builder = await PDFNet.ElementBuilder.create();

  // ElementWriter is used to write Elements to the page
  const writer = await PDFNet.ElementWriter.create();

  // Start a new page
  const pageRect = await PDFNet.Rect.init(0, 0, 612, 794);
  let page = await doc.pageCreate(pageRect);

  // begin writing to the page
  writer.beginOnPage(page);

  // Create an Image that can be reused multiple times in the document or multiple on the same page.
  const img = await PDFNet.Image.createFromURL(doc, imagename);
  let element = await builder.createImageFromMatrix(img, await PDFNet.Matrix2D.create(200, -145, 20, 300, 200, 150));
  writer.writePlacedElement(element);

  // use the same image (just change its matrix)
  let gstate = await element.getGState();
  gstate.setTransform(200, 0, 0, 300, 50, 450);
  writer.writePlacedElement(element);

  // use the same image again (just change its matrix).
  writer.writePlacedElement(await builder.createImageScaled(img, 300, 600, 200, -150));

  // save changes to the current page
  writer.end();

  // Add the new page to the document sequence
  doc.pagePushBack(page);
}
PDFNet.runWithCleanup(main);
```

{% endcode %}
{% endtab %}

{% tab title="Kotlin" %}
{% code lineNumbers="true" %}

```kotlin
val doc = PDFDoc()

// ElementBuilder is used to build new Element objects
val builder = ElementBuilder()  

// ElementWriter is used to write Elements to the page
val writer = ElementWriter()    

// Start a new page
var page = doc.pageCreate(Rect(0.0, 0.0, 612.0, 794.0))

// begin writing to the page
writer.begin(page)

// Create an Image that can be reused multiple times in the document or multiple on the same page.
val img = Image.create(doc.sdfDoc, imagename)
var element = builder.createImage(img, Matrix2D(200.0, -145.0, 20.0, 300.0, 200.0, 150.0))
writer.writePlacedElement(element)

// use the same image (just change its matrix)
var gstate = element.gState()    
gstate.setTransform(200.0, 0.0, 0.0, 300.0, 50.0, 450.0)
writer.writePlacedElement(element)

// use the same image again (just change its matrix).
writer.writePlacedElement(builder.createImage(img, 300.0, 600.0, 200.0, -150.0))

// save changes to the current page
writer.end()  

// Add the new page to the document sequence
doc.pagePushBack(page)
```

{% endcode %}
{% endtab %}

{% tab title="Obj-C" %}
{% code lineNumbers="true" %}

```objc
PTPDFDoc *doc = [[PTPDFDoc alloc] init];

// ElementBuilder is used to build new Element objects
PTElementBuilder *builder = [[PTElementBuilder alloc] init];

// ElementWriter is used to write Elements to the page
PTElementWriter *writer = [[PTElementWriter alloc] init];	

// Start a new page
PTPage *page = [doc PageCreate: [[PTPDFRect alloc] initWithX1: 0 y1: 0 x2: 612 y2: 794]];

// begin writing to the page
[writer WriterBeginWithPage: page placement: e_ptoverlay page_coord_sys: YES compress: YES];	

// Create an Image that can be reused multiple times in the document or multiple on the same page.		
PTImage *img = [PTImage Create: [doc GetSDFDoc] filename: imagename];
PTElement *element = [builder CreateImageWithMatrix:img mtx: [[PTMatrix2D alloc] initWithA: 200 b: -145 c: 20 d: 300 h: 200 v: 150]];
[writer WritePlacedElement: element];

// use the same image (just change its matrix)
PTGState *gstate = [element GetGState];	
[gstate SetTransform: 200 b: 0 c: 0 d: 300 h: 50 v: 450];
[writer WritePlacedElement: element];

// use the same image again (just change its matrix).
[writer WritePlacedElement: [builder CreateImageWithCornerAndScale: img x: 300 y: 600 hscale: 200 vscale: -150]];

// save changes to the current page
[writer End];  

// Add the new page to the document sequence
[doc PagePushBack: page];
```

{% endcode %}
{% endtab %}

{% tab title="Swift" %}
{% code lineNumbers="true" %}

```swift
let doc: PTPDFDoc = PTPDFDoc()

// ElementBuilder is used to build new Element objects
let builder: PTElementBuilder = PTElementBuilder() 

// ElementWriter is used to write Elements to the page
let writer: PTElementWriter = PTElementWriter() 

// Start a new page
var page: PTPage? = doc.pageCreate(PTPDFRect(x1: 0, y1: 0, x2: 612, y2: 794))

// begin writing to the page
writer.writerBegin(with: page, placement: e_ptoverlay, page_coord_sys: true, compress: true)    

// Create an Image that can be reused in the document or on the same page.
let img: PTImage = PTImage.create(doc.getSDFDoc(), filename: imagename)
var element = builder.createImage(withMatrix: img, mtx: PTMatrix2D(a: 300, b: -145, c: 20, d: 200, h: 200, v: 150))
writer.writePlacedElement(element)

// use the same image (just change its matrix)
var gstate = element.getGState()   
gstate.setTransform(200, b: 0, c: 0, d: 300, h: 50, v: 450)
writer.writePlacedElement(element)

// use the same image again (just change its matrix).
writer.writePlacedElement(builder.createImage(withCornerAndScale: img, x: 300, y: 600, hscale: 200, vscale: -150))

// save changes to the current page
writer.end() 

// Add the new page to the document sequence
doc.pagePushBack(page)
```

{% endcode %}
{% endtab %}

{% tab title="PHP" %}
{% code lineNumbers="true" %}

```php
$doc = new PDFDoc();

// ElementBuilder is used to build new Element objects
$builder = new ElementBuilder();

// ElementWriter is used to write Elements to the page
$writer = new ElementWriter();		

// Start a new page
$page = $doc->PageCreate(new Rect(0.0, 0.0, 612.0, 794.0));

// begin writing to the page
$writer->Begin($page);	

// Create an Image that can be reused in the document or on the same page.		
$img = Image::Create($doc->GetSDFDoc(), $imagename);
$element = $builder->CreateImage($img, new Matrix2D(300, -145.0, 20.0, 200, 200.0, 150.0));
$writer->WritePlacedElement($element);

// use the same image (just change its matrix)
$gstate = $element->GetGState();	
$gstate->SetTransform(200.0, 0.0, 0.0, 300.0, 50.0, 450.0);
$writer->WritePlacedElement($element);

// use the same image again (just change its matrix).
$writer->WritePlacedElement($builder->CreateImage($img, 300.0, 600.0, 200.0, -150.0));

// save changes to the current page
$writer->End(); 

// Add the new page to the document sequence
$doc->PagePushBack($page);
```

{% endcode %}
{% endtab %}

{% tab title="Python" %}
{% code lineNumbers="true" %}

```python
doc = PDFDoc()
    
# ElementBuilder is used to build new Element objects
builder = ElementBuilder()

# ElementWriter is used to write Elements to the page
writer = ElementWriter()

# Start a new page ------------------------------------
page = doc.PageCreate(Rect(0, 0, 612, 794))

# begin writing to the page
writer.Begin(page)  

# Create an Image that can be reused in the document or on the same page.
img = Image.Create(doc.GetSDFDoc(), filename)
element = builder.CreateImage(img, Matrix2D(300, -145, 20, 200, 200, 150))
writer.WritePlacedElement(element)

# use the same image (just change its matrix)
gstate = element.GetGState()    
gstate.SetTransform(200, 0, 0, 300, 50, 450)
writer.WritePlacedElement(element)

# use the same image again (just change its matrix)
writer.WritePlacedElement(builder.CreateImage(img, 300, 600, 200, -150))

# save changes to the current page
writer.End()   

# Add the new page to the document sequence
doc.PagePushBack(page)
```

{% endcode %}
{% endtab %}

{% tab title="Ruby" %}
{% code lineNumbers="true" %}

```ruby
doc = PDFDoc.new()
	
# ElementBuilder is used to build new Element objects
builder = ElementBuilder.new()

# ElementWriter is used to write Elements to the page
writer = ElementWriter.new()

# Start a new page ------------------------------------
page = doc.PageCreate(Rect.new(0, 0, 612, 794))

writer.Begin(page)  # begin writing to the page

# Create an Image that can be reused in the document or on the same page.
img = Image.Create(doc.GetSDFDoc(), imagename)
element = builder.CreateImage(img, Matrix2D.new(300, -145, 20, 200, 200, 150))
writer.WritePlacedElement(element)

gstate = element.GetGState()	# use the same image (just change its matrix)
gstate.SetTransform(200, 0, 0, 300, 50, 450)
writer.WritePlacedElement(element)

# use the same image again (just change its matrix)
writer.WritePlacedElement(builder.CreateImage(img, 300, 600, 200, -150))

# save changes to the current page
writer.End()	

# Add the new page to the document sequence
doc.PagePushBack(page)
```

{% endcode %}
{% endtab %}

{% tab title="VB" %}
{% code lineNumbers="true" %}

```vb
Dim doc As PDFDoc = New PDFDoc

' ElementBuilder is used to build new Element objects
Dim builder As ElementBuilder = New ElementBuilder

' ElementWriter is used to write Elements to the page
Dim writer As ElementWriter = New ElementWriter		

' Start a new page
Dim page As Page = doc.PageCreate(New Rect(0, 0, 612, 794))

' begin writing to this page
writer.Begin(page)		             

' Create an Image that can be reused multiple times in the document or multiple on the same page.
Dim img_file As MappedFile = New MappedFile(imagename)
Dim img_data As FilterReader = New FilterReader(img_file)
Dim img As Image = Image.Create(doc.GetSDFDoc(), img_data, 400, 600, 8, ColorSpace.CreateDeviceRGB(), Image.InputFilter.e_jpeg)
Dim element As Element = eb.CreateImage(img, New Matrix2D(200, -145, 20, 300, 200, 150))
writer.WritePlacedElement(element)

' use the same image (just change its matrix)
Dim gstate As GState = element.GetGState()		  
gstate.SetTransform(200, 0, 0, 300, 50, 450)
writer.WritePlacedElement(element)

' use the same image again (just change its matrix).
writer.WritePlacedElement(eb.CreateImage(img, 300, 600, 200, -150))

' save changes to the current page
writer.End()		 

' Add the new page to the document sequence
doc.PagePushBack(page)
```

{% endcode %}
{% endtab %}
{% endtabs %}

[Build, Write, Embed Elements in PDF Pages](/core/get-started/samples/elementbuildertest.md) Full code sample which illustrates how to use PDFNet page writing API, how to embed fonts and images and how to copy graphical elements from one page to another.

## About writing page content

New page content can be added to an existing page or a blank new page using ElementBuilder and ElementWriter. ElementBuilder is used to instantiate one or more Elements that can be written to one or more pages using ElementWriter:

![](https://3779731113-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fziw3GiL98Xfj63F3He8h%2Fuploads%2Fgit-blob-ea16d96af120df93136b29c81a91c2d2e6211a7a%2F27fe7de6ec2dcabb5c4f5d64e7449afb67067285-370x328.gif?alt=media)

Note that once the Element is instantiated using ElementBuilder, you have full control over its properties and graphics state.

Page content can also come from existing pages. For example, you can use ElementReader to read paths, text, and images from existing pages and copy them to the current page. Note that, along the way, you can fully modify an Element's properties or its graphics state. This is how to perform page content editing. For example, the following copies all Elements from an existing page and changes text color to blue:

{% tabs %}
{% tab title="C#" %}
{% code lineNumbers="true" %}

```csharp
PDFDoc doc = new PDFDoc(filename);
ElementWriter writer = new ElementWriter();
ElementReader reader = new ElementReader();

reader.Begin(doc.PageBegin().Current());

Page new_page = doc.PageCreate(new Rect(0, 0, 612, 794));
doc.PagePushBack(new_page);

writer.Begin(new_page);

Element element;
while ((element = reader.Next()) != null)
{
  switch (element.GetType())
  {
    case Element.Type.e_text:
    {
      // Set all text to blue color.
      GState gs = element.GetGState();
      gs.SetFillColorSpace(ColorSpace.CreateDeviceRGB());
      gs.SetFillColor(new ColorPt(0, 0, 1));
      writer.WriteElement(element);
      break;
    }
    default:
      writer.WriteElement(element);
      break;
  }
}

writer.End();
reader.End();
```

{% endcode %}
{% endtab %}

{% tab title="C++" %}
{% code lineNumbers="true" %}

```cpp
PDFDoc doc(filename);
Page first_page = doc.GetPage(1);

ElementWriter writer;
ElementReader reader;
reader.Begin(page);
writer.Begin(page, ElementWriter::e_replacement, false);

Element element;
while (element = reader.Next()) // Read page contents
{
  switch (element.GetType())
  {
    case Element::e_text:
      {
        // Set all text to blue color.
        GState gs = element.GetGState();
        gs.SetFillColorSpace(ColorSpace::CreateDeviceRGB());
        ColorPt cp(0, 0, 1);
        gs.SetFillColor(cp);
        writer.WriteElement(element);
        break;
      }
    default:
      writer.WriteElement(element);
  }
}

writer.End();
reader.End();
```

{% endcode %}
{% endtab %}

{% tab title="Go" %}
{% code lineNumbers="true" %}

```go
doc := NewPDFDoc(filename)
page := doc.GetPage(1)

writer := NewElementWriter()
reader := NewElementReader()
reader.Begin(page)
writer.Begin(page, ElementWriterE_replacement, false)

element := reader.Next()     
for element.GetMp_elem().Swigcptr() != 0{ // Read page contents
  etype := element.GetType()
  if etype == ElementE_text {
    // Set all text to blue color.
    gs := element.GetGState()
    gs.SetFillColorSpace(ColorSpaceCreateDeviceRGB())
    cp := NewColorPt(0.0, 0.0, 1.0)
    gs.SetFillColor(cp)
    writer.WriteElement(element)
  } else {
    writer.WriteElement(element)
  }
  element = reader.Next()
}

reader.End()
writer.End()
```

{% endcode %}
{% endtab %}

{% tab title="Java" %}
{% code lineNumbers="true" %}

```java
PDFDoc doc = new PDFDoc(filename);
Page first_page = doc.getPage(1);

ElementWriter writer = new ElementWriter();
ElementReader reader = new ElementReader();
reader.begin(page);
writer.begin(page, ElementWriter.e_replacement, false);

Element element;
while ((element = reader.next()) != null) 
{
    switch (element.getType()) {
      case Element.e_text: {
          // Set all text to blue color.
          GState gs = element.getGState();
          gs.setFillColorSpace(ColorSpace.createDeviceRGB());
          gs.setFillColor(new ColorPt(0, 0, 1));
          writer.writeElement(element);
      }
      break;
      default:
          writer.writeElement(element);
          break;
  }
}

writer.end();
reader.end();
```

{% endcode %}
{% endtab %}

{% tab title="JavaScript" %}
{% code lineNumbers="true" %}

```js
async function main() {
  const doc = await PDFNet.PDFDoc.createFromURL(filename);
  const firstPage = await doc.getPage(1);

  const writer = await PDFNet.ElementWriter.create();
  const reader = await PDFNet.ElementReader.create();
  reader.beginOnPage(page);
  writer.beginOnPage(page, PDFNet.ElementWriter.WriteMode.e_replacement, false);

  for (let element = await reader.next(); element !== null; element = await reader.next()) 
  {
    const elementType = await element.getType();
    switch (elementType) {
      case PDFNet.Element.Type.e_text:
        // Set all text to blue
        gs = await element.getGState();
        gs.setFillColorSpace(colorspace);
        gs.setFillColorWithColorPt(blueColor);
        writer.writeElement(element);
        break;
      default:
        writer.writeElement(element);
    }
  }

  writer.end();
  reader.end();
}
PDFNet.runWithCleanup(main);
```

{% endcode %}
{% endtab %}

{% tab title="Kotlin" %}
{% code lineNumbers="true" %}

```kotlin
val doc = PDFDoc(filename)
val first_page = doc.getPage(1)

val writer = ElementWriter()
val reader = ElementReader()
reader.begin(page)
writer.begin(page, ElementWriter.e_replacement, false)

var element = reader.next()
while (element != null)
{
  when (element.type) {
    Element.e_text -> {
        // Set all text to blue color.
        val gs = element.gState
        gs.fillColorSpace = ColorSpace.createDeviceRGB()
        gs.fillColor = ColorPt(0.0, 0.0, 1.0)
        writer.writeElement(element)
    }
    else -> writer.writeElement(element)
  }
  element = reader.next()
}

writer.end()
reader.end()
```

{% endcode %}
{% endtab %}

{% tab title="Obj-C" %}
{% code lineNumbers="true" %}

```objc
PTPDFDoc *doc = [[PTPDFDoc alloc] initWithFilepath: filename];
PTPage *first_page = [doc GetPage:1];

PTElementWriter *writer = [[PTElementWriter alloc] init];
PTElementReader *reader = [[PTElementReader alloc] init];
[reader Begin: page];
[writer Begin: page placement: e_ptreplacement page_coord_sys: NO];

PTElement *element;	
while ((element = [reader Next])) 	// Read page contents
{
  switch ([element GetType])
  {		
    case e_pttext_obj:
      {
        // Set all text to blue color.
        PTGState *gs = [element GetGState];
        [gs SetFillColorSpace: [PTColorSpace CreateDeviceRGB]];
        PTColorPt *cp = [[PTColorPt alloc] initWithX: 0 y: 0 z: 1 w: 0];
        [gs SetFillColorWithColorPt: cp];
        [writer WriteElement: element];
        break;
      }
    default:
        [writer WriteElement: element];
  }
}

[writer End];
[reader End];
```

{% endcode %}
{% endtab %}

{% tab title="Swift" %}
{% code lineNumbers="true" %}

```swift
let doc: PTPDFDoc = PTPDFDoc(filepath: filename)
let first_page: PTPage = doc.getPage(1)

let writer: PTElementWriter = PTElementWriter()
let reader: PTElementReader = PTElementReader()
reader.begin(page)
writer.begin(page, placement: e_ptreplacement, page_coord_sys: false)

while let element = reader.next()
{
  switch element.getType() {
    case e_pttext_obj:
        // Set all text to blue color.
        let gs: PTGState = element.getGState()
        gs.setFill(PTColorSpace.createDeviceRGB())
        let cp = PTColorPt(x: 0, y: 0, z: 1, w: 0)
        gs.setFillColor(with: cp)
        writer.write(element)
    default:
        writer.write(element)
  }
}

writer.end()
reader.end()
```

{% endcode %}
{% endtab %}

{% tab title="PHP" %}
{% code lineNumbers="true" %}

```php
$doc = new PDFDoc($filename);
$first_page = $doc->GetPage(1);

$writer = new ElementWriter();
$reader = new ElementReader();
$reader->Begin($page);
$writer->Begin($page, ElementWriter::e_replacement, false);

while (($element = $reader->Next()) != null) 	// Read page contents
{
  switch ($element->GetType())
  {		
    case Element::e_text:
      {
        // Set all text to blue color.
        $gs = $element->GetGState();
        $gs->SetFillColorSpace(ColorSpace::CreateDeviceRGB());
        $cp = new ColorPt(0.0, 0.0, 1.0);
        $gs->SetFillColor($cp);
        $writer->WriteElement($element);
        break;
      }
    default:
      $writer->WriteElement($element);
  }
}

$writer->End();
$reader->End();
```

{% endcode %}
{% endtab %}

{% tab title="Python" %}
{% code lineNumbers="true" %}

```python
doc = PDFDoc(filename)
first_page = doc.GetPage(1)

writer = ElementWriter()
reader = ElementReader()
reader.Begin(page)
writer.Begin(page, ElementWriter.e_replacement, False)

element = reader.Next()     # Read page contents
while element != None:
    type = element.GetType()
    if type == Element.e_text:
      # Set all text to blue color.
      gs = element.GetGState()
      gs.SetFillColorSpace(ColorSpace.CreateDeviceRGB())
      cp = ColorPt(0, 0, 1)
      gs.SetFillColor(cp)
      writer.WriteElement(element)
    else:
      writer.WriteElement(element)
    element = reader.Next()
writer.End()
reader.End()
```

{% endcode %}
{% endtab %}

{% tab title="Ruby" %}
{% code lineNumbers="true" %}

```ruby
doc = PDFDoc.new(filename)
first_page = doc.GetPage(1)

writer = ElementWriter.new()
reader = ElementReader.new()
reader.Begin(page)
writer.Begin(page, ElementWriter::E_replacement, false)

element = reader.Next()	 # Read page contents
while !element.nil? do
    type = element.GetType()
    case type
		when Element::E_text
			# Set all text to blue color.
			gs = element.GetGState()
			gs.SetFillColorSpace(ColorSpace.CreateDeviceRGB())
			cp = ColorPt.new(0, 0, 1)
			gs.SetFillColor(cp)
			writer.WriteElement(element)
		else
			writer.WriteElement(element)
		end
    element = reader.Next()
end

writer.End()
reader.End()
```

{% endcode %}
{% endtab %}

{% tab title="VB" %}
{% code lineNumbers="true" %}

```vb
Dim doc As PDFDoc = New PDFDoc(filename)
Dim page As Page = doc.GetPage(1)

Dim writer As ElementWriter = New ElementWriter
Dim reader As ElementReader = New ElementReader
reader.Begin(page)
writer.Begin(page, ElementWriter.WriteMode.e_replacement, False)

Dim element As Element = reader.Next()
While Not IsNothing(element) ' Read page contents
  If element.GetType() = element.Type.e_text Then
    ' Set all text to blue color.
    Dim gs As GState = element.GetGState()
    gs.SetFillColorSpace(ColorSpace.CreateDeviceRGB())
    gs.SetFillColor(New ColorPt(0, 0, 1))
    writer.WriteElement(element)
  Else
    writer.WriteElement(element)
  End If
  element = reader.Next()
End While

writer.End()
reader.End()
```

{% endcode %}
{% endtab %}
{% endtabs %}

[PDF Editor (Programmatic)](/core/get-started/samples/elementedittest.md) Full code sample which strips all images from the page and changes text color to blue. Code sample is available in C++, C#, Java, Python, Go, PHP, Ruby & VB


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.apryse.com/core/pdf-editing/write.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.