---
name: "load_pcx_pf"
section: "3alleg"
platform: "linux"
package: "liballegro-doc"
version: "2:4.2.2-2.2"
release: "Debian 6.0 (Squeeze)"
platforms: ["linux"]
url: "https://new.carta.tech/load_pcx_pf"
---

# load\_pcx\_pf(3alleg)

Packfile version of load\_pcx. Allegro game programming library.

## NAME

load\_pcx\_pf - Packfile version of load\_pcx. Allegro game programming library.

## SYNOPSIS

**#include \<allegro.h\>**

**BITMAP \*load\_pcx\_pf(PACKFILE \*f, RGB \*pal);**

## DESCRIPTION

A version of load\_pcx() which reads from a packfile. Example:

```
   PACKFILE *packfile;
   BITMAP *bmp;
   packfile = pack_fopen("mybitmap.pcx", F_READ);
   if (!packfile)
      abort_on_error("Couldn't open mybitmap.pcx");
   bmp = load_bmp_pf(packfile, pal);
   if (!bmp)
      abort_on_error("Error loading mybitmap.pcx");
```

## RETURN VALUE

Returns a pointer to the bitmap or NULL on error. Remember that you are responsible for destroying the bitmap when you are finished with it to avoid memory leaks.

## SEE ALSO

[**load\_pcx**(3alleg)](/load_pcx/3alleg.md), [**expackf**(3alleg)](/expackf/3alleg.md)