Extensions - Revision history

Dedmen: Extension signature verification

2026-04-14T17:11:35Z

Extension signature verification

← Older revision		Revision as of 19:11, 14 April 2026
Line 1,278:		Line 1,278:
	That function will be called every frame to check if an update is required, and provides a performance advantage over updating the texture anyway even though it didn't change.		That function will be called every frame to check if an update is required, and provides a performance advantage over updating the texture anyway even though it didn't change.
	Textures are only checked for updates, if it is visible on screen and considered for rendering.		Textures are only checked for updates, if it is visible on screen and considered for rendering.

			{{ArgTitle\|2\|Extension Signatures\|{{GVI\|arma3\|2.22}}}}

			DLLs can be signed on windows with SignTool [https://learn.microsoft.com/en-us/windows/win32/appxpkg/how-to-sign-a-package-using-signtool "How to sign an app package using SignTool"]
			Self signed certificates are possible!

			[[allExtensions]] and "ExtensionLoaded" eventhandler provide signature information.
			Important is the "status" field.
			"badDigest" means the signature does not match the file, likely the file was modified after it was signed, the signature cannot be trusted.
			"expired" means the signature is now expired, but it might still have been valid when the signature was created.
			"revoked" means the signature was revoked after the file was signed, likely because the certificate is compromised, it might not be trustworthy.
			"partialChain" means the full certificate chain could not be verified, while the known certificate is valid, it might have been created by a invalid authority, it might not be trustworthy.
			"ok" is set if there were no errors with the validation (Certificate is valid and matches the file, but we ignore expiry date, ignore self signed certificates ), it is better to check individual status values than just relying on this.

			The recommended method to check is to make sure that "badDigest" is not set (The file was actually really signed by the certificate, and not modified afterwards), and that the certificate's public key matches the expected one (It was signed by the intended certificate, and not a self-signed certificate someone else created).


			Signature verification script can be set in config
			<syntaxhighlight lang="cpp">
			class CfgExtensions {
			class MyModName {
			extensions[] = {"extension1", "extension2"}; // Whitelist, which extension names to run this check on (so its not ran on unrelated extensions we don't care about)
			onCheckLoad = "call MyMod_fnc_checkExtensionLoad";
			publicKey = "308201...E4EA81730203010001"; // The handler has access to the config class, so we can store some properties here)
			}
			}
			</syntaxhighlight>


			<sqf>
			MyMod_fnc_checkExtensionLoad = {

			if !("signatures" in _this) exitWith { true; }; // This must be linux, it doesn't have signature reading. We'll just skip validation here

			// must have signature, so signatures can't be empty
			if ((_this get "signatures") isNotEqualTo []) exitWith { false; };

			// Find a signature that is..
			_validSignatureFound = (_this get "signatures"]) findIf {
			(_x get "publicKey") == getText((_this get "config") >> "publicKey") // Signed by my key (Easy access to config that added the handler, so can store the key there)
			&&
			!("expired" in (_x get "status")) // Not expired
			&&
			!("badDigest" in (_x get "status")) // The signature actually matches the binary (it was not edited after signing)
			};

			_validSignatureFound != -1 // If signature found we load, otherwise we block
			}
			</sqf>

Leopard20: Added tip for .NET users

2026-02-23T09:48:20Z

Added tip for .NET users

← Older revision		Revision as of 11:48, 23 February 2026
Line 188:		Line 188:
	Go to: {{hl\|Project->Properties->Build tab->Conditional compilation symbols}}, add {{hl\|WIN32}} for your {{hl\|x86}} platform and {{hl\|WIN64}} for your {{hl\|x64}} platform. Save.		Go to: {{hl\|Project->Properties->Build tab->Conditional compilation symbols}}, add {{hl\|WIN32}} for your {{hl\|x86}} platform and {{hl\|WIN64}} for your {{hl\|x64}} platform. Save.
	Rename resulting {{hl\|WIN64}} {{hl\|dllname.dll}} to {{hl\|dllname_x64.dll}}.		Rename resulting {{hl\|WIN64}} {{hl\|dllname.dll}} to {{hl\|dllname_x64.dll}}.
			}}
			{{Feature\|informative\|
			If you intend to use .NET instead of .NET Framework, the '''UnmanagedExports''' package above might not work properly. Use {{Link\|https://github.com/3F/DllExport\|DllExport}} instead
	}}		}}
	<syntaxhighlight lang="c#">		<syntaxhighlight lang="c#">

Dedmen: Update utility header

2025-08-21T12:38:03Z

Update utility header

← Older revision		Revision as of 14:38, 21 August 2025
Line 744:		Line 744:
	};		};
	#endif		#endif

			enum TextureFormat : uint32_t
			{
			PacAI88 = 1,
			PacARGB8888 = 5
			};

	#ifdef _WIN32		#ifdef _WIN32
Line 779:		Line 785:
	//--- Request creation of UI element		//--- Request creation of UI element
	DLLEXPORT bool CALL_CONVENTION RVExtensionRequestUI(const char* uiClass, CExtensionControlInterface* interfaceStruct);		DLLEXPORT bool CALL_CONVENTION RVExtensionRequestUI(const char* uiClass, CExtensionControlInterface* interfaceStruct);
			//--- Request filling in a Extension Texture Source
			DLLEXPORT void CALL_CONVENTION RVExtensionFillTextureSource(const char* uniqueName, uint16_t width, uint16_t height, uint16_t pitch, uint8_t mipLevel, TextureFormat format, void* buffer);
			DLLEXPORT bool CALL_CONVENTION RVExtensionHasTextureSourceUpdate(const char* uniqueName);
	}		}

Dedmen: RVExtensionHasTextureSourceUpdate

2025-08-21T11:43:13Z

RVExtensionHasTextureSourceUpdate

← Older revision		Revision as of 13:43, 21 August 2025
Line 162:		Line 162:
	//--- Request filling in a Extension Texture Source		//--- Request filling in a Extension Texture Source
	__declspec (dllexport) void __stdcall RVExtensionFillTextureSource(const char* uniqueName, uint16_t width, uint16_t height, uint16_t pitch, uint8_t mipLevel, uint32_t format, void* buffer);		__declspec (dllexport) void __stdcall RVExtensionFillTextureSource(const char* uniqueName, uint16_t width, uint16_t height, uint16_t pitch, uint8_t mipLevel, uint32_t format, void* buffer);
			//--- Check if a animated Extension Texture Source should be updated
			__declspec (dllexport) bool __stdcall RVExtensionHasTextureSourceUpdate(const char* uniqueName);
	</syntaxhighlight>		</syntaxhighlight>

Line 1,253:		Line 1,255:
	Procedural texture source (#TODO link to the wiki page, and also document it there)		Procedural texture source (#TODO link to the wiki page, and also document it there)

	#(rgb,width,height,nMips)extension("RVExtensionName","UniqueName")		#(rgb,width,height,nMips)extension("RVExtensionName","UniqueName", isAnimated, textureType)

	RVExtensionFillTextureSource will be called whenever the engine needs to fill the texture.		RVExtensionFillTextureSource will be called whenever the engine needs to fill the texture.
Line 1,260:		Line 1,262:

	In video/animated mode, the texture is re-loaded/re-requested from the extension, every frame that the texture is visible on-screen. Be mindful of performance.		In video/animated mode, the texture is re-loaded/re-requested from the extension, every frame that the texture is visible on-screen. Be mindful of performance.

			When using animated textures that do not have to update every frame, it is recommended to implement RVExtensionHasTextureSourceUpdate.
			That function will be called every frame to check if an update is required, and provides a performance advantage over updating the texture anyway even though it didn't change.
			Textures are only checked for updates, if it is visible on screen and considered for rendering.

Dedmen: Extension Texture Source (incomplete)

2025-08-20T16:36:02Z

Extension Texture Source (incomplete)

← Older revision		Revision as of 18:36, 20 August 2025
Line 12:		Line 12:
	* {{GVI\|arma3\|2.12}} {{Link\|#Context}} became available.		* {{GVI\|arma3\|2.12}} {{Link\|#Context}} became available.
	* {{GVI\|arma3\|2.18}} {{hl\|{{Link\|#Feature Flags\|RVExtensionFeatureFlags}}}} and {{Link\|#Game Functions}} became available.		* {{GVI\|arma3\|2.18}} {{hl\|{{Link\|#Feature Flags\|RVExtensionFeatureFlags}}}} and {{Link\|#Game Functions}} became available.
			* {{GVI\|arma3\|2.20}} {{hl\|{{Link\|Extension_UI\|Extension UI}}}} became available.
			* {{GVI\|arma3\|2.22}} {{hl\|{{Link\|Extension_Texture_Source\|Extension Texture Source}}}} became available.



Line 157:		Line 160:
	//--- Request creation of UI element		//--- Request creation of UI element
	__declspec (dllexport) bool __stdcall RVExtensionRequestUI(const char uiClass, void interfaceStruct);		__declspec (dllexport) bool __stdcall RVExtensionRequestUI(const char uiClass, void interfaceStruct);
			//--- Request filling in a Extension Texture Source
			__declspec (dllexport) void __stdcall RVExtensionFillTextureSource(const char* uniqueName, uint16_t width, uint16_t height, uint16_t pitch, uint8_t mipLevel, uint32_t format, void* buffer);
	</syntaxhighlight>		</syntaxhighlight>

Line 1,243:		Line 1,248:
	The default is a RenderTarget, the Game will set the active RenderTarget before the call to "OnDraw", and every DirectX render command will render into it.<br>		The default is a RenderTarget, the Game will set the active RenderTarget before the call to "OnDraw", and every DirectX render command will render into it.<br>
	The alternative is setting {{hl\|CExtensionControlInterface::Flags::DynamicTexture}} into the "flags" member of the interface structure. Then the Game will provide a texture allocated with {{hl\|D3D11_USAGE_DYNAMIC}}, which can be mapped using {{hl\|d3dDeviceContext->Map}} and the {{hl\|D3D11_MAP_WRITE_DISCARD}} MapType, and the CPU can then write data into the mapped memory.		The alternative is setting {{hl\|CExtensionControlInterface::Flags::DynamicTexture}} into the "flags" member of the interface structure. Then the Game will provide a texture allocated with {{hl\|D3D11_USAGE_DYNAMIC}}, which can be mapped using {{hl\|d3dDeviceContext->Map}} and the {{hl\|D3D11_MAP_WRITE_DISCARD}} MapType, and the CPU can then write data into the mapped memory.

			{{ArgTitle\|2\|Extension Texture Source\|{{GVI\|arma3\|2.22}}}}

			Procedural texture source (#TODO link to the wiki page, and also document it there)

			#(rgb,width,height,nMips)extension("RVExtensionName","UniqueName")

			RVExtensionFillTextureSource will be called whenever the engine needs to fill the texture.
			The Texture will be stored in video memory. It may be deleted from Video memory at any time, and when its visible on screen again it will be re-fetched from extension.
			The extension fetch is done on a separate texture loading thread.

			In video/animated mode, the texture is re-loaded/re-requested from the extension, every frame that the texture is visible on-screen. Be mindful of performance.

Dedmen: RVExtensionGGetR2TTexture

2025-07-18T08:45:53Z

RVExtensionGGetR2TTexture

← Older revision		Revision as of 10:45, 18 July 2025
Line 864:		Line 864:
	\|-		\|-
	\| RVExtensionGSetResetHook \|\| <syntaxhighlight lang="cpp">typedef void (CALL_CONVENTION RVExtensionGSetResetHook)(void (CALL_CONVENTION *newHook)());</syntaxhighlight> \|\| Sets a hook that gets called when the game 3D engine is shut down. At this point the extension must destroy its D3D resources and release the pointers to the D3D device/context.		\| RVExtensionGSetResetHook \|\| <syntaxhighlight lang="cpp">typedef void (CALL_CONVENTION RVExtensionGSetResetHook)(void (CALL_CONVENTION *newHook)());</syntaxhighlight> \|\| Sets a hook that gets called when the game 3D engine is shut down. At this point the extension must destroy its D3D resources and release the pointers to the D3D device/context.
			\|-
			\| RVExtensionGGetR2TTexture {{GVI\|arma3\|2.22}} \|\| <syntaxhighlight lang="cpp">typedef void (CALL_CONVENTION RVExtensionGGetR2TTexture)(const char* name, void (CALLCONVENTION onResult)(ID3D11Texture2D texture, ID3D11ShaderResourceView* resView, ID3D11RenderTargetView* rtView, uint32_t width, uint32_t height, uint32_t lastSeenFrameID, const char* name));</syntaxhighlight> \|\| Retrieves R2T texture's by name, name can be nullptr, in which case all textures are returned via the callback.
	\|}		\|}

Dedmen: Add RVFeature_ArgumentNoEscapeString

2025-06-26T13:38:54Z

Add RVFeature_ArgumentNoEscapeString

← Older revision		Revision as of 15:38, 26 June 2025
Line 632:		Line 632:
	RVFeature_ContextStackTrace = 1 << 1,		RVFeature_ContextStackTrace = 1 << 1,
	RVFeature_ContextNoDefaultCall = 1 << 2,		RVFeature_ContextNoDefaultCall = 1 << 2,
			RVFeature_ArgumentNoEscapeString = 1 << 3,
	};		};

Line 802:		Line 803:
	* {{hl\|RVFeature_ContextStackTrace}} - RVExtensionContext will retrieve a full Stacktrace - see {{Link\|#Context}}.		* {{hl\|RVFeature_ContextStackTrace}} - RVExtensionContext will retrieve a full Stacktrace - see {{Link\|#Context}}.
	* {{hl\|RVFeature_ContextNoDefaultCall}} - RVExtensionContext will not be called automatically. It must be manually requested via RVExtensionRequestContext (This improves performance when context is not needed).		* {{hl\|RVFeature_ContextNoDefaultCall}} - RVExtensionContext will not be called automatically. It must be manually requested via RVExtensionRequestContext (This improves performance when context is not needed).
			* {{GVI\|arma3\|2.22}} {{hl\|RVFeature_ArgumentNoEscapeString}} - RVExtensionArgs string arguments will not be escaped (double-quoted) and instead passed directly. Provides significant performance advantage, and removes the need to un-escape the strings after receiving them.

	Setting Flags		Setting Flags

Leopard20 at 18:52, 7 March 2025

2025-03-07T18:52:52Z

← Older revision		Revision as of 20:52, 7 March 2025
Line 861:		Line 861:
	\| RVExtensionGSetWHk \|\| <syntaxhighlight lang="cpp">typedef void (CALL_CONVENTION RVExtensionGSetWHkProc)(bool (CALL_CONVENTION *newHook)(HWND hwnd, UINT msg, WPARAM wParam, LPARAM lParam));</syntaxhighlight> \|\| Sets a WNDPROC hook to handle mouse/key inputs when rendering external UI.		\| RVExtensionGSetWHk \|\| <syntaxhighlight lang="cpp">typedef void (CALL_CONVENTION RVExtensionGSetWHkProc)(bool (CALL_CONVENTION *newHook)(HWND hwnd, UINT msg, WPARAM wParam, LPARAM lParam));</syntaxhighlight> \|\| Sets a WNDPROC hook to handle mouse/key inputs when rendering external UI.
	\|-		\|-
	\| RVExtensionGSetResetHook \|\| <syntaxhighlight lang="cpp">typedef void (CALL_CONVENTION RVExtensionGSetResetHook)(void (CALL_CONVENTION *newHook)());</syntaxhighlight> \|\| Sets a hook that gets called when the game 3D engine is shut down. At this point the extension must destroy its resources and release the ~~game~~ pointers.		\| RVExtensionGSetResetHook \|\| <syntaxhighlight lang="cpp">typedef void (CALL_CONVENTION RVExtensionGSetResetHook)(void (CALL_CONVENTION *newHook)());</syntaxhighlight> \|\| Sets a hook that gets called when the game 3D engine is shut down. At this point the extension must destroy its D3D resources and release the pointers to the D3D device/context.
	\|}		\|}

Leopard20 at 14:52, 7 March 2025

2025-03-07T14:52:16Z

← Older revision		Revision as of 16:52, 7 March 2025
Line 859:		Line 859:
	typedef void (CALL_CONVENTION RVGetProjectionViewTransformProc)(ProjectionViewTransform& pvTransform);</syntaxhighlight> \|\| Returns the projection and camera view (i.e. "look at") matrices for drawing 3D content. The matrices are row-major. The camera view matrix is left-handed.		typedef void (CALL_CONVENTION RVGetProjectionViewTransformProc)(ProjectionViewTransform& pvTransform);</syntaxhighlight> \|\| Returns the projection and camera view (i.e. "look at") matrices for drawing 3D content. The matrices are row-major. The camera view matrix is left-handed.
	\|-		\|-
	\| RVExtensionGSetWHk \|\| <syntaxhighlight lang="cpp">typedef void (CALL_CONVENTION RVExtensionGSetWHkProc)(bool (*newHook)(HWND hwnd, UINT msg, WPARAM wParam, LPARAM lParam));</syntaxhighlight> \|\| Sets a WNDPROC hook to handle mouse/key inputs when rendering external UI.		\| RVExtensionGSetWHk \|\| <syntaxhighlight lang="cpp">typedef void (CALL_CONVENTION RVExtensionGSetWHkProc)(bool (CALL_CONVENTION *newHook)(HWND hwnd, UINT msg, WPARAM wParam, LPARAM lParam));</syntaxhighlight> \|\| Sets a WNDPROC hook to handle mouse/key inputs when rendering external UI.
	\|-		\|-
	\| RVExtensionGSetResetHook \|\| <syntaxhighlight lang="cpp">typedef void (CALL_CONVENTION RVExtensionGSetResetHook )(void (CALL_CONVENTION *newHook)());</syntaxhighlight> \|\| Sets a hook that gets called when the game 3D engine is shut down. At this point the extension must destroy its resources and release the game pointers.		\| RVExtensionGSetResetHook \|\| <syntaxhighlight lang="cpp">typedef void (CALL_CONVENTION RVExtensionGSetResetHook)(void (CALL_CONVENTION *newHook)());</syntaxhighlight> \|\| Sets a hook that gets called when the game 3D engine is shut down. At this point the extension must destroy its resources and release the game pointers.
	\|}		\|}

Leopard20: Add RVExtensionGSetResetHook

2025-03-07T14:37:08Z

Add RVExtensionGSetResetHook

← Older revision		Revision as of 16:37, 7 March 2025
Line 860:		Line 860:
	\|-		\|-
	\| RVExtensionGSetWHk \|\| <syntaxhighlight lang="cpp">typedef void (CALL_CONVENTION RVExtensionGSetWHkProc)(bool (*newHook)(HWND hwnd, UINT msg, WPARAM wParam, LPARAM lParam));</syntaxhighlight> \|\| Sets a WNDPROC hook to handle mouse/key inputs when rendering external UI.		\| RVExtensionGSetWHk \|\| <syntaxhighlight lang="cpp">typedef void (CALL_CONVENTION RVExtensionGSetWHkProc)(bool (*newHook)(HWND hwnd, UINT msg, WPARAM wParam, LPARAM lParam));</syntaxhighlight> \|\| Sets a WNDPROC hook to handle mouse/key inputs when rendering external UI.
			\|-
			\| RVExtensionGSetResetHook \|\| <syntaxhighlight lang="cpp">typedef void (CALL_CONVENTION RVExtensionGSetResetHook )(void (CALL_CONVENTION *newHook)());</syntaxhighlight> \|\| Sets a hook that gets called when the game 3D engine is shut down. At this point the extension must destroy its resources and release the game pointers.
	\|}		\|}