Replaced sample image of mdecimage example, added dummy hooks for sio tty device, updated some documentation in libn00bref.odf

8 files changed, 46 insertions, 23 deletions

diff --git a/CHANGELOG.md b/CHANGELOG.md
index b8a57b9..6ab68d2 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -19,14 +19,31 @@ to ensure the changelog can be parsed correctly.
 
 -------------------------------------------------------------------------------
 
-## 2022-02-27: 0.19
+## 2022-03-25: 0.19
+
+lameguy64:
+
+- examples: Replaced sample image of mdec/mdecimage with different artwork.
+  Original image: http://lameguy64.net/?page=drawings&post_id=9
+
+- examples: Updated readme file in examples directory to reference the new
+  mdecimage example program.
+
+- psxsio: Added dummy hooks to unsupported device functions for tty device.
+
+- docs: Minor corrections on dev_notes.md.
+
+- docs: Updated documentation for CdGetSector() and CdReadCallback()
+  functions in libn00bref.odt.
+
+## 2022-02-27:
 
 spicyjpeg:
 
 - libpsn00b: Added `hwregs_c.h` header and renamed some registers in
   `hwregs_a.h`. Added `assert()` as a proper macro.
 
-- psxpress: Added new MDEC library.
+- libpsn00b: Added new MDEC library; psxpress.
 
 - psxspu: Fixed critical bug in `SpuSetReverb()`.
 
diff --git a/doc/LibPSn00b Reference.odt b/doc/LibPSn00b Reference.odt
index c997d2a..44543fd 100644
--- a/doc/LibPSn00b Reference.odt
+++ b/doc/LibPSn00b Reference.odt
diff --git a/doc/dev_notes.md b/doc/dev_notes.md
index a96d6ef..3c3aa55 100644
--- a/doc/dev_notes.md
+++ b/doc/dev_notes.md
@@ -85,15 +85,15 @@ _- spicyjpeg_
   `GPUSTAT` (`1F801814h`) to alternate on every frame (frame 0: wait until 0,
   frame 1: wait until 1, frame 2: wait until 0) before waiting for VSync
   otherwise the GPU will only draw the first field if you don't have drawing to
-  displayed area enabled. Performing this check in a low resolution/non
-  interlaced mode is harmless.
+  displayed area enabled. Performing this wait operation in non-interlaced modes
+  is harmless.
 
 - There's a hardware bug in the GPU `FillVRAM` command `GP0(02h)` where if you
-  set the height to 512 pixels the primitive is processed with a height of 0 as
-  the hardware does not appear to interpret the last bit of the height value.
-  This is most apparent when putting a DRAWENV with the height of 512 pixels
-  (for PAL for example) and background clearing is enabled, hence why
-  `DRAWENV.isbg` is not effective in the official SDK.
+  set the height to 512 pixels the primitive is drawn with a height of 0 as
+  the hardware does not appear to interpret the last bit of the height field.
+  This is most apparent when applying a DRAWENV with the height of 512 pixels
+  (for PAL standard for example) and isbg is set, hence this method also does
+  not work in the official SDK either.
 
 - The controller/memory card SPI interface is poorly implemented in most
   emulators, making custom controller polling code insanely hard to write and
@@ -280,4 +280,4 @@ _- spicyjpeg_
   space.
 
 -----------------------------------------
-_Last updated on 2022-02-06 by spicyjpeg_
+_Last updated on 2022-03-25 by lameguy64_
diff --git a/examples/README.md b/examples/README.md
index 8b84e5e..4025a56 100644
--- a/examples/README.md
+++ b/examples/README.md
@@ -19,13 +19,14 @@ Additional information may be found in the source code of each example.
 | [`graphics/gte`](./graphics/gte)               | Displays a rotating cube using GTE macros             | EXE  |       |
 | [`graphics/hdtv`](./graphics/hdtv)             | Demonstrates anamorphic widescreen at 704x480         | EXE  |       |
 | [`graphics/render2tex`](./graphics/render2tex) | Procedural texture effects using off-screen drawing   | EXE  |       |
-| [`graphics/rgb24`](./graphics/rgb24)           | Displays a 640x480 24-bit RGB image                   | EXE  |       |
+| [`graphics/rgb24`](./graphics/rgb24)           | Displays an uncompressed 640x480 24-bit RGB image     | EXE  |       |
 | [`graphics/tilesasm`](./graphics/tilesasm)     | Drawing a tile-map with assembly language             | EXE  |       |
 | [`io/pads`](./io/pads)                         | Demonstrates reading controllers via low-level access | EXE  |   3   |
 | [`io/system573`](./io/system573)               | Konami System 573 (PS1-based arcade board) example    | CD   |       |
 | [`lowlevel/cartrom`](./lowlevel/cartrom)       | ROM firmware for cheat devices written using GNU GAS  | ROM  |   4   |
+| [`mdec/mdecimage`](./mdec/mdecimage)           | Displays a (raw) MDEC format image using libpsxpress  | EXE  |       |
 | [`sound/spustream`](./sound/spustream)         | Custom (non XA) CD-ROM audio streaming using the SPU  | CD   |   1   |
-| [`sound/vagsample`](./sound/vagsample)         | Demonstrates playing VAG sound files with the SPU     | EXE  |       |
+| [`sound/vagsample`](./sound/vagsample)         | Demonstrates playing VAG sound files using the SPU    | EXE  |       |
 | [`system/childexec`](./system/childexec)       | Loading a child program and returning to parent       | EXE  |       |
 | [`system/console`](./system/console)           | TTY based text console that interrupts gameplay       | EXE  |       |
 | [`system/dynlink`](./system/dynlink)           | Demonstrates dynamically linked libraries             | CD   |       |
diff --git a/examples/mdec/mdecimage/bunpattern.png b/examples/mdec/mdecimage/bunpattern.png
deleted file mode 100644
index 61524f8..0000000
--- a/examples/mdec/mdecimage/bunpattern.png
+++ /dev/null
diff --git a/examples/mdec/mdecimage/image.bin b/examples/mdec/mdecimage/image.bin
index 976b4b6..53f81b9 100644
--- a/examples/mdec/mdecimage/image.bin
+++ b/examples/mdec/mdecimage/image.bin
diff --git a/examples/mdec/mdecimage/parkway.png b/examples/mdec/mdecimage/parkway.png
new file mode 100644
index 0000000..758514d
--- /dev/null
+++ b/examples/mdec/mdecimage/parkway.png
diff --git a/libpsn00b/psxsio/siocons.c b/libpsn00b/psxsio/siocons.c
index db35eda..5937920 100644
--- a/libpsn00b/psxsio/siocons.c
+++ b/libpsn00b/psxsio/siocons.c
@@ -117,6 +117,11 @@ static void _sio_tty_cb(void)
 	_sio_control(2, 1, 0);
 }
 
+static int _sio_dummy(void)
+{
+	return -1;
+}
+
 static DCB _sio_dcb = {
 	"tty",
 	0x3,
@@ -127,17 +132,17 @@ static DCB _sio_dcb = {
 	(void*)_sio_inout,	// inout
 	_sio_close,			// close
 	_sio_ioctl,			// ioctl
-	NULL,				// read
-	NULL,				// write
-	NULL,				// erase
-	NULL,				// undelete
-	NULL,				// firstfile
-	NULL,				// nextfile
-	NULL,				// format
-	NULL,				// chdir
-	NULL,				// rename
-	NULL,				// remove
-	NULL				// testdevice
+	_sio_dummy,			// read
+	_sio_dummy,			// write
+	_sio_dummy,			// erase
+	_sio_dummy,			// undelete
+	_sio_dummy,			// firstfile
+	_sio_dummy,			// nextfile
+	_sio_dummy,			// format
+	_sio_dummy,			// chdir
+	_sio_dummy,			// rename
+	_sio_dummy,			// remove
+	_sio_dummy			// testdevice
 };