---
name: "instanceface"
section: "3"
platform: "linux"
package: "alliance"
version: "5.1.1-3"
release: "Debian 10 (Buster)"
platforms: ["linux"]
url: "https://new.carta.tech/instanceface"
---

# instanceface(3)

returns the face of a connector in a placed instance

## NAME

instanceface - returns the face of a connector in a placed instance

## SYNOPSYS

```
#include "mph403.h"
void ∗instanceface(modelface, symmetry)
char modelface, symmetry;
```

## PARAMETERS

- *modelface*

  Face of a connector in its figure.

- *symmetry*

  Geometrical operation applied to the instanciation of the figure.

## DESCRIPTION

**instanceface** determines the orientation of a connector in an instance of its model.

## EXAMPLE

```
#include "mph403.h"
char channelFace(channelDir, i, c)
char channelDir;
phins_list *i;
phcon_list *c;
{
	if (channelDir == VER)
		switch (instanceface(c->ORIENT, i->TRANSF)) {
			case EAST :
				return WEST;
			case WEST :
				return EAST;
			default :
				return instanceface(c->ORIENT, i->TRANSF);
		}
	else
		switch (instanceface(c->ORIENT, i->TRANSF)) {
			case NORTH :
				return SOUTH;
			case SOUTH :
				return NORTH;
			default :
				return instanceface(c->ORIENT, i->TRANSF);
		}
}
```

## SEE ALSO

**mbk**(1), [**phcon**(3)](/phcon/3.md), [**phfig**(3)](/phfig/3.md), [**phins**(3)](/phins/3.md).