gwyndolynmarchant / gzphotography

A small bespoke mod which adds a photography camera into any gzDoom load order

gzPhotography

gzPhotography is a small bespoke mod which adds a photography camera into any gzDoom load order. It has been designed with maximum compatibility with other mods, placing the camera in your inventory under slot 0, and providing a universal printscreen button replacement which takes clean, unobstructed photos.

To enable photo-taking, you will need to turn on Options > Miscellaneous > Enable making screenshots by script.

Features

Sorry Cyberimp DSC-P72

The photography camera is a "weapon" which allows taking clean photographs by "firing", and clean selfies by "alt-firing".

It has clean animations and graphics based on a Sony Cybershot DSC-P72. It does not aim to replicate this camera in functionality, it is just a cute model that i thought made a good visual reference. Due to the aim of being maximally compatible with other mods, the camera is presented "floating" as opposed to showing specific hands.

Selfie Mode

Alt-firing produces a selfie, by placing the camera in front of you and shooting backwards. Note that this means you will not be photographing what is in front of you, but instead what is behind you. Moving will return the perspective to normal.

Flash and Fill Flash

Fill Modes

The photography camera features both a flash and fill-flash for photographing dark rooms and close-up objects. They can be seperately toggled in the options menu. The full flash is toggleable with a keybinding (default configuration F for "Flash").

Universal clean screenshots

A series of console commands are preconfigured (taken from the zdoom wiki) that enable taking clean screenshots in any load order. Unlike the camera itself, these screenshots have been configured to replace the default in-engine PrintScreen with the new clean shots. The hotkey can be changed in the options menu.

Shot composition overlays

The camera supports multple composition overlays, which can be toggled to cycle through them (default configuration G for "Grid"). These exist as seperate crosshairs, and thus can have their scaling tweaked from the options menu. The camera crosshair is selected seperately from your main crosshairs.

Note that the camera overlay will follow the same colouring as your crosshair.

Overlays

• None (default)
• Thirds
• Golden Ratio
• Root 2 Armature
• Diamond

Photo information overlay

When taking a picture, you may have the mod print map and megawad information onto the photograph. This feature is toggleable in the settings, and provides an override to megawad detection. The color of the overlay defaults to white, but can be changed in the options menu. Note that megawad detection is performed upon starting play, not entering the main menu.

The photo information overlay features two fonts:

• VCR OSD Overlay by Riciery Leal
• OCR A Extended

Compatibility Notes

• Fill flash may not work correctly with mods which modify the default firing modes of weapons in the engine. (ex: Castlevania: Simon's Destiny)
• The camera will not be accessible or functional with mods which entirely disable weapons. (ex: GZ P.T.) In these cases, the universal hotkey should still function.
• Screen clearing is done by translating the screen 42069 screen units down-right, so if there's anything else being drawn in that corner it will be revealed.
• Although the photography mod itself works on all preconfigured screen resolutions, some options menu text will be cut off at resolutions below 1024 horizontal pixels

For full compatibility notes, please see the documentation.

gzphotography's Issues

Transfer camera inventory assignment from ACS to zscript

Currently the camera is loaded into inventory from a universal ACS injector, and I think it would be better if instead it ran on a zscript eventlistener at play state

Seperate offset inversion code into seperate CVAR

Currently at WorldLoaded the game checks which vid_rendermode is active, and if it is 4 (hardware) it uses positive offsets instead of negatives. This mostly works, but i am trying to debug edge cases and it would be better if it was a seperate value.

Current cvars:

• camera_osd_offset : float ; defines where off-screen text is being rendered

Proposed change:

• camera_osd_offset : float ; defines how far off-screen OSD is being rendered
• camera_osd_neg : bool ; defines whether OSD is in positive or negative space

List mods which are known to be (in)compatible

In testing I have primarily been playing either vanilla Doom 2 or a bit of a complicated Demolitionist setup, but I should probably check out some other mods and see what does or doesn't work.

Transfer camera flash toggle code from ACS to zscript

Currently, pressing the camera flash toggle button activates an ACS function, whereas I would rather it work on pure zscript for portability reasons.