diff --git a/IIDX-TDJ-Camera-Hook-and-Play-Recording.md b/IIDX-TDJ-Camera-Hook-and-Play-Recording.md deleted file mode 100644 index 921644f..0000000 --- a/IIDX-TDJ-Camera-Hook-and-Play-Recording.md +++ /dev/null @@ -1,113 +0,0 @@ -## TDJ play recording - -Starting with IIDX28, TDJ cabinets can record your plays and upload videos to the server. This works with spice2x as well. - -### Requirements -* Requires IIDX28+ and **TDJ DLL (010)**, and game booted in **TDJ mode**. - * Other DLL types (e.g., 003, 012) will not work as the DLLs are missing the ability to record, no matter how hard you try. -* **Requires server side support** - * Check with server operator on how to correctly configure your account and game install. -* Requires NVENC compatible NVIDIA GPU. - * If you have a NVIDIA GPU made after 2012, you should be OK. - * Make sure you're **not** using stub NVIDIA DLLs. - -### How to use -Start the game and go into song select. Bring up the subscreen, and click on the Videos icon. Go through the menu, and enable the feature. You only have to do this once per account. - -Once the feature is enabled, play a song, and on the result screen, click on Videos icon again. It'll prompt you to pay extra for this, accept and a video will start uploading to the server. - -Uploading to the server will automatically happen in the background while the game is running; it can take a while. You can check on the progress by going to the test menu, `Lightning Model Settings`, `Play Video`, and then `Video Upload Progress`. - -### FAQ - -#### Some songs cannot be recorded? - -This is like this at the arcades as well. Not all songs can be recorded due to licensing restrictions built into the game. Songs that can be recorded have a movie icon in song select. - -To enable recording for all songs, find and apply a patch named `Disable Recording Lock`. - -#### Someone told me I need a touch screen to enable recording? (What is -nod3d9devhook?) -tl;dr - this used to be the case, but not anymore. - -Prior to `spice2x-24-08-03`, the game would crash when play record is enabled, unless `-nod3d9devhook` flag was enabled. The flag disables all Direct3D hooks, which also disabled a lot of features (like subscreen overlay, touch emulation, screenshot, etc) - which means a touch screen was required to enable play record in the past. - -Starting with `spice2x-24-08-03`, this flag is no longer required; play record should "just work" without disabling graphics features. This means touch screens are no longer required. - -#### Game started to crash after I enabled play recording feature -First of all, you **need** an NVIDIA GPU that supports NVENC. If you don't have one, then it simply will not work; turn play record feature off. - -Second, if you're on a laptop with hybrid GPU (iGPU + dGPU setup), then things may not work correctly until you figure out how to run the game exclusively on the dGPU. Even then, things might be funky, so you are on your own. - -Finally, if you're on NVIDIA and the game still crashes when enabling the feature, try updating NVIDIA drivers, root cause is not identified yet. - -#### Are videos stored locally? -An mp4 file gets saved to `dev/vfs/drive_f/videos2` but it's not in a format that is playable. The file is automatically deleted once fully uploaded. - -For a local implementation of the server try this project: https://github.com/bookqaq/010-record-api - -#### Camera shows as blank in play recording video - -See the last section on this page about using `top` camera instead `front` camera. - -## TDJ Camera Hook - -### Requirements -Requires compatible DLL, and you must boot into TDJ mode. spice2x should work with most DLLs, with notable exceptions: - -* For IIDX 27, only the final datecode is supported out of the box. -* IIDX 30 003 does not support camera at all. - -For cameras: -* Most modern USB webcams should work, as long as it supports `YUY2` or `NV12` format. -* Some software camera emulators will work, while others will not. Devices must show up in Windows Media Foundation in order for Spice to access them. - * If you want to use your smartphone, try something like [Camo Studio](https://reincubate.com/camo/). - * Notably, *OBS Virtual Cam* doesn't work as it can only output to DirectShow. - * Look into [2dxcamhook](https://github.com/aixxe/2dxcamhook) instead which uses another protocol (Spout). - -### Camera options overlay -To adjust camera parameters (brightness, exposure, focus, etc), go to the Overlay tab in spicecfg, and bind a key to `Toggle Camera Control`. Bring this up in-game and adjust your camera. - -### FAQ - -#### Camera is not detected in game or test menu -Check the log for messages from `tdjcam`. Most likely, your DLL is not supported. - -#### My DLL is not supported? -If you know the offsets for your DLL, you can override them using `IIDX TDJ Cam Hook Offset Override (-iidxtdjcamhookoffset)` option. Take a look at [this repo](https://github.com/aixxe/2dxcamhook/tree/master/versions) for examples. - -#### My camera is cut off / squished / wrong aspect ratio -Bring up the camera control overlay and change the draw settings. - -#### I want to flip / rotate / mirror my camera image -As of version `24-09-14` this is possible to do in the Camera Control overlay. - -Note: `IIDX Camera Order Flip (-iidxflipcams)` does not "flip" your camera image, it's for changing which of your cameras is used for FRONT vs. TOP camera. - -#### Image is low resolution / low FPS -Bring up the camera control overlay and change the resolution/framerate settings. - -#### I'm trying to display only my controller but the top camera view is cut off -One of the camera layout option in game is to only display the control deck. This needs a manual "focus". Go to test menu, `I/O Check`, `Camera Check` and change the `TRIMMING` value until the red box is located where you desire. - -#### What I see in Test Menu and in-game are completely different -It's to be expected, the game just does that - namely, the displayed aspect ratio is different. Adjust aspect ratio and cropping options during the song in the camera overlay menu. - -#### Camera options in test menu do not work -This is by design. Use the camera control overlay instead. - -#### I have two cameras and they are in the wrong order (front and top cameras) -Use `IIDX Camera Order Flip (-iidxflipcams)` option. - -#### I have three or more cameras and spice is picking up the wrong ones -Update to `spice2x-24-11-20` and use `-iidxtdjcamhooktop` and `-iidxtdjcamhookfront` options. - -#### Can I combine TDJ camera hook with play record feature? -Yes! It'll work as you expect, **but**: - -Make sure your webcam is bound to the `top` camera and not the `front` camera. The game will intentionally blank out the front face camera in recordings, so you **must** use the top camera for play record feature. Check or uncheck `IIDX Camera Order Flip` option to switch the ordering. - -Also, be mindful of your privacy as the recorded video with your camera feed will be uploaded to your EA server. spice2x has no control over where your videos are uploaded or how it's shared. - -#### Turning on camera hook causes unstable monitor check / high CPU usage - -Cameras are always on while the game is running. Lower the resolution and refresh rate for your camera using the camera overlay. You really don't need anything higher than 720p.