rendertarget_reconfigure(3)

okay bestie, pull up a chair — this is rendertarget_reconfigure(3), and yes, it's from the Arcan Lua API manual. It's the call that changes a rendertarget's output density or processing flags, and we're gonna read it together like the iconic little doc it is. 💖

✨ NAME ✨

rendertarget_reconfigure — Change the output density or processing flags of a rendertarget. like, that's the whole name. no cap. 🎀

🫶 SYNOPSIS 🫶

here's the exact shape, bestie:

nil
rendertarget_reconfigure( vid:rtgt, float:hppcm, float:vppcm )

so it gives you nil and takes those three args exactly: vid:rtgt, float:hppcm, and float:vppcm. copy-paste energy only — don't rename them. 💅

💅 DESCRIPTION 💅

okay so two major properties of a rendertarget are the intended output density and the targetted colour space. those are the main character properties here. ✨

for vectorized assets that are sized in physical units — e.g. pt (1/72th of an inch), like with render_text — the engine needs knowledge of the target output before drawing. it cannot just vibe its way through. 🫶

by default, this is some display-dependent initial size, accessible through the global constants HPPCM and VPPCM, or 38.4 when those cannot be found. so yeah: those globals are the default vibe, and 38.4 is the fallback. 💖

when targeting a display, locally or remote, that has a different density, it is typically advised to update the rendertarget pipeline that gets mapped to that output using this function. that's literally the whole point of this call. 🌈

whenever an asset gets created or attached to a rendertarget, it will be rerastered to match the density of the rendertarget. so density changes ripple through — iconic behavior, no cap. 🔥

🎀 NOTES: 🎀

1. for HDR composition and rendering, you typically need to provide further metadata about light levels and so on. this can be set on the rtgt using image_metadata. noted, bestie — don't forget the metadata. 🎀

👑 SEE ALSO: 👑

• targetcontrol — the one and only SEE ALSO reference on this page. go look if you need it. 👑

---

mwah 💋 — that's the page. the footer's source/version tag is targetcontrol, and the date is October 2026. now go forth and reconfigure something gorgeous. 🦋