---
name: "PDF::Builder::Basic::PDF::Filter"
section: "3pm"
platform: "linux"
package: "perl-pdf-builder"
version: "3.028-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/PDF::Builder::Basic::PDF::Filter"
---

# PDF::Builder::Basic::PDF::Filter(3pm)

Abstract superclass for PDF stream filters

## NAME

PDF::Builder::Basic::PDF::Filter - Abstract superclass for PDF stream filters

## SYNOPSIS

```
    $f = PDF::Builder::Basic::PDF::Filter->new();
    $str = $f->outfilt($str, 1);
    print OUTFILE $str;
    while (read(INFILE, $dat, 4096))
    { $store .= $f->infilt($dat, 0); }
    $store .= $f->infilt("", 1);
```

## DESCRIPTION

A Filter object contains state information for the process of outputting and inputting data through the filter. The precise state information stored is up to the particular filter and may range from nothing to whole objects created and destroyed.

Each filter stores different state information for input and output and thus may handle one input filtering process and one output filtering process at the same time.

## METHODS

### new

```
    PDF::Builder::Basic::PDF::Filter->new()
```

Creates a new filter object with empty state information ready for processing data both input and output.

### infilt

```
    $dat = $f->infilt($str, $isend)
```

Filters from output to input the data. Notice that `"$isend == 0"` implies that  there is more data to come and so following it `$f` may contain state  information (usually due to the break-off point of `$str` not being tidy).  Subsequent calls will incorporate this stored state information.

`"$isend == 1"` implies that there is no more data to follow. The final state of  `$f` will be that the state information is empty. Error messages are most  likely to occur here since if there is required state information to be stored  following this data, then that would imply an error in the data.

### outfilt

```
    $str = $f->outfilt($dat, $isend)
```

Filter stored data ready for output. Parallels `"infilt"`.