From 31f61cac69bce302a54092694ea72e1a31cbd1a0 Mon Sep 17 00:00:00 2001
From: Dominic Masters <dominic@domsplace.com>
Date: Mon, 26 Jul 2021 09:55:09 -0700
Subject: [PATCH] Still working on some VN elements, it's coming together
 slowly.

---
 include/dawn/display/animation/easing.h   |  10 ++
 include/dawn/display/animation/timeline.h |   2 +-
 include/dawn/util/rand.h                  |  48 +++++++---
 include/dawn/vn/vncharacter.h             |  14 ++-
 include/dawn/vn/vnconversation.h          |  43 +++++++--
 src/test/testscene.c                      |  96 ++++++++++++++------
 src/test/testscene.h                      |   7 +-
 src/util/array.c                          |   2 +-
 src/vn/vncharacter.c                      | 106 +++++++++++++++++++++-
 src/vn/vncharacter.h                      |   9 ++
 src/vn/vncharacterconversation.c          |  35 +++++++
 src/vn/vncharacterconversation.h          |  15 +++
 src/vn/vnconversation.c                   |  23 ++++-
 src/vn/vnconversation.h                   |  10 +-
 14 files changed, 359 insertions(+), 61 deletions(-)
 create mode 100644 src/vn/vncharacterconversation.c
 create mode 100644 src/vn/vncharacterconversation.h

diff --git a/include/dawn/display/animation/easing.h b/include/dawn/display/animation/easing.h
index 53b89901..fb5e0808 100644
--- a/include/dawn/display/animation/easing.h
+++ b/include/dawn/display/animation/easing.h
@@ -15,6 +15,16 @@
  */
 #define easeTimeToEase(start, current, duration) ((current-start)/duration)
 
+/**
+ * Animation tool for converting 0-1 space into a 0-0.5 back to zero space. This
+ * is intended to make a "Forward then backwards" effect for animation. This 
+ * method will not scale t.
+ * @param t Time in space to back and fourth on between 0 and 1.
+ * @returns Forward and backwards time. 0 to 0.5 are as such, 0.5 to 1 are from
+ * 0.5 to 0.
+ */
+#define easeTimeToForwardAndBackward(t) (t < 0.5 ? t : 1 - t)
+
 // Easing Functions, most were sourced from https://gist.github.com/gre/1650294
 #define easeLinear(t) t
 
diff --git a/include/dawn/display/animation/timeline.h b/include/dawn/display/animation/timeline.h
index 29d9f586..db462226 100644
--- a/include/dawn/display/animation/timeline.h
+++ b/include/dawn/display/animation/timeline.h
@@ -9,7 +9,7 @@
 #include "../../libs.h"
 
 /** Maximum number of actions a timeline can support, smaller than 0xFF */
-#define TIMELINE_ACTION_COUNT_MAX 32
+#define TIMELINE_ACTION_COUNT_MAX 128
 
 /** Type forwarders */
 typedef struct _timeline_t timeline_t;
diff --git a/include/dawn/util/rand.h b/include/dawn/util/rand.h
index c55b0c8c..401f8397 100644
--- a/include/dawn/util/rand.h
+++ b/include/dawn/util/rand.h
@@ -7,22 +7,44 @@
 
 #pragma once
 #include <dawn/dawn.h>
+#include "math.h"
 
 /**
- * Generate a number between 0 and max. (max exclusive)
- * 
- * @param max Max number to generate
- * @return Number between 0 and max.
+ * Generates a random int32_t.
+ * @returns A random int32_t number.
  */
-#define u32rand(max) (rand()%max)
-#define u8rand(max) (uint8_t)u23rand(max)
+#define randInt32() ((int32_t)rand())
 
 /**
- * Generate a number between min and max. (max exclusive, min inclusive)
- * 
- * @param min Min number to generate.
- * @param max Max number to generate.
- * @return Number between min and max.
+ * Generates a random floating point number.
+ * @returns A random floating point number.
  */
-#define u32randRange(min, max) (u32rand(max-min)+min)
-#define u8randRange(min, max) (uint8_t)u32randRange(min,max)
\ No newline at end of file
+#define randFloat() (((float)randInt32()) * M_PI)
+
+/**
+ * Generates a random uint32_t
+ * @returns A random uint32_t number.
+ */
+#define randUint32() (uint32_t)randInt32()
+
+/**
+ * Generates a random uint8_t
+ * @returns A random uint8_t number.
+ */
+#define randUint8() (uint8_t)randInt32()
+
+////////////////////////////////////////////////////////////////////////////////
+
+/**
+ * Clamps a random number generation.
+ * @param n Number that has been generated from the random.
+ * @param min Minimum value to generate from. (Inclusive)
+ * @param max Maximum value to generate to. (Exclusive)
+ * @return Random number between min and max.
+ */
+#define randRange(n, min, max) (mathMod(n, max - min) + min)
+
+#define randInt32Range(min, max) randRange(randInt32(), min, max)
+#define randFloatRange(min, max) (fmod(randFloat(), max- min) + min)
+#define randUint32Range(min, max) randRange(randUint32(), min, max)
+#define randUint8Range(min, max) randRange(randUint8(), min, max)
\ No newline at end of file
diff --git a/include/dawn/vn/vncharacter.h b/include/dawn/vn/vncharacter.h
index 3ae5a94e..c811c196 100644
--- a/include/dawn/vn/vncharacter.h
+++ b/include/dawn/vn/vncharacter.h
@@ -11,21 +11,27 @@
 #include "../display/primitive.h"
 #include "../display/tileset.h"
 
-#define VNCHARACTER_EMOTION_NEUTRAL 0x00
+#define VN_CHARACTER_BLINK_TIME_RANGE_MAX 6
+#define VN_CHARACTER_SIZE 0.5
 
 typedef struct {
   float x, y, z;
   float yaw, pitch, roll;
+  float scaleX, scaleY;
 
-  uint8_t emotion;
   bool talking;
+  float blinkStart;
 
-  float t;
+  tileset_t tilesetEyes;
+  tileset_t tilesetMouth;
   
   texture_t *textureEyes;
   texture_t *textureBody;
   texture_t *textureMouth;
   texture_t *textureFace;
 
-  primitive_t primitive;
+  primitive_t primitiveEyes;
+  primitive_t primitiveBody;
+  primitive_t primitiveMouth;
+  primitive_t primitiveFace;
 } vncharacter_t;
\ No newline at end of file
diff --git a/include/dawn/vn/vnconversation.h b/include/dawn/vn/vnconversation.h
index 1c2581e1..e05f9c48 100644
--- a/include/dawn/vn/vnconversation.h
+++ b/include/dawn/vn/vnconversation.h
@@ -11,10 +11,24 @@
 
 #define VN_CONVERSATION_TEXT_COUNT_MAX 32
 
-#define VN_CONVERSATION_TYPE_DELAY 0x01
-#define VN_CONVERSATION_TYPE_TEXT 0x02
+// Type Forwarders
+
+typedef struct _vnconversationtext_t vnconversationtext_t;
+typedef struct _vnconversation_t vnconversation_t;
+
+/**
+ * Callback for conversation text events.
+ * @param conversation Conversation this text is attached to.
+ * @param text Text item that is being used in the callback
+ */
+typedef void vnconversationcallback_t(vnconversation_t *conversation,
+  vnconversationtext_t *text
+);
+
+typedef struct _vnconversationtext_t {
+  /** Pointer to any custom user data for this text action. */
+  void *data;
 
-typedef struct {
   /** Conversation Type to decide what this data is used for */
   uint8_t type;
 
@@ -23,15 +37,32 @@ typedef struct {
 
   /** Time in seconds to delay if type is delay */
   float delay;
+
+  /** Callback to fire the moment the text is active in the conversation */
+  vnconversationcallback_t *onStart;
+
+  /** Callback to fire every update tick of this conversation element */
+  vnconversationcallback_t *onUpdate;
+
+  /** Callback to fire when this conversation element is ended */
+  vnconversationcallback_t *onEnd;
 } vnconversationtext_t;
 
-typedef struct {
+/** Representation of a conversation, laid out similarly to a timeline. */
+typedef struct _vnconversation_t {
+  /** Internal Textbox for text elements */
   vntextbox_t textbox;
-  vnconversationtext_t texts[VN_CONVERSATION_TEXT_COUNT_MAX];
 
+  /** Array of text elements */
+  vnconversationtext_t texts[VN_CONVERSATION_TEXT_COUNT_MAX];
+  uint8_t textCount;
+
+  /** Internal timeline tracking */
   float timeline;
+
+  /** When the current text was first attached */
   float delayStart;
 
-  uint8_t textCount;
+  /** Current index within the array of texts that is currently processing */
   uint8_t textCurrent;
 } vnconversation_t;
\ No newline at end of file
diff --git a/src/test/testscene.c b/src/test/testscene.c
index 4d3c19c5..fb3c9bbf 100644
--- a/src/test/testscene.c
+++ b/src/test/testscene.c
@@ -9,48 +9,88 @@
 
 void testSceneInit(testscene_t *scene, game_t *game) {
   vnconversationtext_t *text;
+  
   assetFontLoad(&scene->font, "fonts/opensans/OpenSans-Bold.ttf");
   assetShaderLoad(&scene->shader,
     "shaders/textured.vert", "shaders/textured.frag"
   );
 
-  assetTextureLoad(&scene->pennyEyes, "characters/penny/textures/eyes.png");
-  assetTextureLoad(&scene->pennyBody, "characters/penny/textures/body.png");
-  assetTextureLoad(&scene->pennyFace, "characters/penny/textures/face.png");
-  assetTextureLoad(&scene->pennyMouth, "characters/penny/textures/mouth.png");
-  characterInit(&scene->character,
+  vnConversationInit(&scene->conversation, &scene->font);
+  scene->conversation.textbox.linesMax = 3;
+  scene->conversation.textbox.widthMax = game->engine.render.width;
+
+  text = vnCharacterConversationSetTalking(
+    &scene->character1, &scene->conversation, true
+  );
+
+  text = vnConversationAdd(&scene->conversation);
+  text->text = "Hello World";
+
+  // text = vnConversationAdd(&scene->conversation);
+  // text->text = "How are you today?";
+
+  text = vnCharacterConversationSetTalking(
+    &scene->character1, &scene->conversation, false
+  );
+
+
+  assetTextureLoad(&scene->pennyEyes, "characters/penny/textures/eyes_sm.png");
+  assetTextureLoad(&scene->pennyBody, "characters/penny/textures/body_sm.png");
+  assetTextureLoad(&scene->pennyMouth,"characters/penny/textures/mouth_sm.png");
+  assetTextureLoad(&scene->pennyFace, "characters/penny/textures/face_sm.png");
+  
+  vnCharacterInit(&scene->character1,
     &scene->pennyEyes,
     &scene->pennyBody,
     &scene->pennyMouth,
     &scene->pennyFace
   );
+  
+  vnCharacterInit(&scene->character2,
+    &scene->pennyEyes,
+    &scene->pennyBody,
+    &scene->pennyMouth,
+    &scene->pennyFace
+  );
+
+  scene->character1.x = 0;
+  scene->character2.x = 1;
+  scene->character1.y = 0;
+  scene->character2.y = 0;
+
+  vnConversationNext(&scene->conversation);
 }
 
 void testSceneRender(testscene_t *scene, game_t *game) {
-  if(false) {
-    cameraLookAt(&scene->camera,
-      300, 300, 300,
-      0, 0, 0
-    );
-    cameraPerspective(&scene->camera, 75,
-      game->engine.render.width/game->engine.render.height, 0.01, 1000.0
-    );
-  } else {
-    cameraLookAt(&scene->camera,
-      0, 0, 10,
-      0, 0, 0
-    );
-
-    cameraOrtho(&scene->camera,
-      0, game->engine.render.width,
-      game->engine.render.height, 0,
-      0.01, 1000.0
-    );
-  }
+  cameraLookAt(&scene->camera,
+    0.5, 0.5, 0.75,
+    0.5, 0.5, -0.5
+  );
+  cameraPerspective(&scene->camera, 75,
+    game->engine.render.width/game->engine.render.height, 0.01, 1000.0
+  );
 
   shaderUse(&scene->shader);
   shaderUseCamera(&scene->shader, &scene->camera);
-  vnCharacterRender(&scene->character, &scene->shader);
-  // conversationUpdate(&scene->conv, &game->engine);
-  // conversationRender(&scene->conv, &scene->shader);
+
+  vnCharacterUpdate(&scene->character1, &game->engine);
+  vnCharacterUpdate(&scene->character2, &game->engine);
+  vnConversationUpdate(&scene->conversation, &game->engine);
+
+  vnCharacterRender(&scene->character1, &scene->shader);
+  vnCharacterRender(&scene->character2, &scene->shader);
+
+  
+  cameraLookAt(&scene->camera,
+    0, 0, 10,
+    0, 0, 0
+  );
+
+  cameraOrtho(&scene->camera,
+    0, game->engine.render.width,
+    game->engine.render.height, 0,
+    0.01, 1000.0
+  );
+  shaderUseCamera(&scene->shader, &scene->camera);
+  vnConversationRender(&scene->conversation, &scene->shader);
 }
\ No newline at end of file
diff --git a/src/test/testscene.h b/src/test/testscene.h
index fb24212a..7ece7b23 100644
--- a/src/test/testscene.h
+++ b/src/test/testscene.h
@@ -15,13 +15,18 @@
 #include "../display/gui/font.h"
 #include "../display/texture.h"
 #include "../vn/vncharacter.h"
+#include "../vn/vnconversation.h"
+#include "../vn/vncharacterconversation.h"
 
 typedef struct {
   shader_t shader;
   camera_t camera;
   font_t font;
   
-  vncharacter_t character;
+  vnconversation_t conversation;
+
+  vncharacter_t character1;
+  vncharacter_t character2;
 
   texture_t pennyEyes;
   texture_t pennyBody;
diff --git a/src/util/array.c b/src/util/array.c
index 511abdbb..445dfa7d 100644
--- a/src/util/array.c
+++ b/src/util/array.c
@@ -18,7 +18,7 @@ void arrayShuffle(size_t size, void *array, int32_t arrayLength) {
 
   for(x = 0; x < arrayLength-1; x++) {
     // Select random element from remaining elements.
-    y = u8randRange(x, arrayLength);
+    y = randUint8Range(x, arrayLength);
 
     itemDest = arrayGet(size, array, y);
     itemSource = arrayGet(size, array, x);
diff --git a/src/vn/vncharacter.c b/src/vn/vncharacter.c
index 88013fcb..0131fa15 100644
--- a/src/vn/vncharacter.c
+++ b/src/vn/vncharacter.c
@@ -7,12 +7,21 @@
 
 #include "vncharacter.h"
 
+void _vnCharacterQuad(primitive_t *primitive, tilesetdiv_t *div) {
+  quadInit(primitive, 0,
+    -VN_CHARACTER_SIZE, 0,                   div->x0, div->y1,
+     VN_CHARACTER_SIZE, VN_CHARACTER_SIZE*2, div->x1, div->y0
+  );
+}
+
 void vnCharacterInit(vncharacter_t *character,
   texture_t *textureEyes,
   texture_t *textureBody,
   texture_t *textureMouth,
   texture_t *textureFace
 ) {
+  tilesetdiv_t div;
+
   character->x = 0;
   character->y = 0;
   character->z = 0;
@@ -21,18 +30,109 @@ void vnCharacterInit(vncharacter_t *character,
   character->pitch = 0;
   character->roll = 0;
 
+  character->scaleX = 1;
+  character->scaleY = 1;
+
+  character->talking = false;
+  character->blinkStart = randFloatRange(0, VN_CHARACTER_BLINK_TIME_RANGE_MAX);
+
   // Setup Textures
   character->textureEyes = textureEyes;
   character->textureBody = textureBody;
   character->textureMouth = textureMouth;
   character->textureFace = textureFace;
 
-  character->emotion = VNCHARACTER_EMOTION_NEUTRAL;
-  character->talking = false;
+  // Tileset
+  tilesetInit(&character->tilesetEyes, 1, 6,
+    textureEyes->width, textureEyes->height,
+    0, 0, 0, 0
+  );
+  tilesetInit(&character->tilesetMouth, 1, 11,
+    textureMouth->width, textureMouth->height,
+    0, 0, 0, 0
+  );
 
-  character->t = 0;
+  vnCharacterSetEyes(character, 0);
+  vnCharacterSetMouth(character, 9);
+
+  div.x0 = 0, div.x1 = 1;
+  div.y0 = 0, div.y1 = 1;
+
+  _vnCharacterQuad(&character->primitiveBody, &div);
+  _vnCharacterQuad(&character->primitiveFace, &div);
+}
+
+
+void vnCharacterSetEyes(vncharacter_t *character, uint8_t eyes) {
+  tilesetdiv_t *div;
+  div = character->tilesetEyes.divisions + eyes;
+  _vnCharacterQuad(&character->primitiveEyes, div);
+}
+
+void vnCharacterSetMouth(vncharacter_t *character, uint8_t mouth) {
+  tilesetdiv_t *div;
+  div = character->tilesetMouth.divisions + mouth;
+  _vnCharacterQuad(&character->primitiveMouth, div);
+}
+
+void vnCharacterUpdate(vncharacter_t *character, engine_t *engine) {
+  float n;
+
+  // Update the blinking frames
+  n = (engine->time.current - character->blinkStart) * 1.5;
+  if(n >= 1) {
+    character->blinkStart = engine->time.current + randFloatRange(
+      1, VN_CHARACTER_BLINK_TIME_RANGE_MAX
+    );
+  } else if(n > 0) {
+    n = easeInQuad(easeTimeToForwardAndBackward(n) * 2);
+    vnCharacterSetEyes(character, n * character->tilesetEyes.count);
+  }
+
+  // Updating the talking frames
+  if(character->talking) {
+    vnCharacterSetMouth(character,
+      (int32_t)(engine->time.current*12) % character->tilesetMouth.count
+    );
+  } else {
+    vnCharacterSetMouth(character, 9);
+  }
+
+  // Update the scale frames
+  float speed, amount;
+  if(character->talking) {
+    speed = 2.5;
+    amount = 100;
+    n = easeTimeToForwardAndBackward(fmod(engine->time.current, 1 / speed) * speed) * 2;
+    n = easeInOutQuad(n) / amount - (1/(amount*2));
+    character->scaleX = 1 + n;
+    character->scaleY = 1 - n;
+  } else {
+    speed = 10;
+    amount = 50;
+    n = easeTimeToForwardAndBackward(fmod(engine->time.current, speed) / speed)*2;
+    n = easeInOutCubic(n) / amount - (1/(amount*2));
+    character->scaleX = 1 + n;
+    character->scaleY = 1 + n*2;
+  }
 }
 
 void vnCharacterRender(vncharacter_t *character, shader_t *shader) {
+  shaderUsePositionAndScale(shader,
+    character->x, character->y, character->z,
+    character->pitch, character->yaw, character->roll,
+    character->scaleX, character->scaleY, 1
+  );
 
+  shaderUseTexture(shader, character->textureBody);
+  primitiveDraw(&character->primitiveBody, 0, -1);
+
+  shaderUseTexture(shader, character->textureFace);
+  primitiveDraw(&character->primitiveFace, 0, -1);
+
+  shaderUseTexture(shader, character->textureEyes);
+  primitiveDraw(&character->primitiveEyes, 0, -1);
+
+  shaderUseTexture(shader, character->textureMouth);
+  primitiveDraw(&character->primitiveMouth, 0, -1);
 }
\ No newline at end of file
diff --git a/src/vn/vncharacter.h b/src/vn/vncharacter.h
index 0a29aac6..9825e6ca 100644
--- a/src/vn/vncharacter.h
+++ b/src/vn/vncharacter.h
@@ -7,6 +7,12 @@
 
 #pragma once
 #include <dawn/dawn.h>
+#include "../display/texture.h"
+#include "../display/tileset.h"
+#include "../display/primitive.h"
+#include "../display/shader.h"
+#include "../display/primitives/quad.h"
+#include "vnconversation.h"
 
 void vnCharacterInit(vncharacter_t *character,
   texture_t *textureEyes,
@@ -15,4 +21,7 @@ void vnCharacterInit(vncharacter_t *character,
   texture_t *textureFace
 );
 
+void vnCharacterSetEyes(vncharacter_t *character, uint8_t eyes);
+void vnCharacterSetMouth(vncharacter_t *character, uint8_t mouth);
+void vnCharacterUpdate(vncharacter_t *character, engine_t *engine);
 void vnCharacterRender(vncharacter_t *character, shader_t *shader);
\ No newline at end of file
diff --git a/src/vn/vncharacterconversation.c b/src/vn/vncharacterconversation.c
new file mode 100644
index 00000000..7c15ab45
--- /dev/null
+++ b/src/vn/vncharacterconversation.c
@@ -0,0 +1,35 @@
+/**
+ * Copyright (c) 2021 Dominic Masters
+ * 
+ * This software is released under the MIT License.
+ * https://opensource.org/licenses/MIT
+ */
+
+#include "vncharacterconversation.h"
+
+void _vnCharacterConversationTalkingOn(
+  vnconversation_t *convo, vnconversationtext_t *text
+) {
+  vncharacter_t *character = (vncharacter_t *)text->data;
+  character->talking = true;
+  vnConversationNext(convo);
+}
+void _vnCharacterConversationTalkingOff(
+  vnconversation_t *convo, vnconversationtext_t *text
+) {
+  vncharacter_t *character = (vncharacter_t *)text->data;
+  character->talking = false;
+  vnConversationNext(convo);
+}
+
+vnconversationtext_t * vnCharacterConversationSetTalking(
+  vncharacter_t *character, vnconversation_t *conversation, bool talking
+) {
+  vnconversationtext_t *text;
+  text = vnConversationAdd(conversation);
+  text->data = character;
+  text->onStart = talking ? (
+    &_vnCharacterConversationTalkingOn 
+  ) : &_vnCharacterConversationTalkingOff;
+  return text;
+}
\ No newline at end of file
diff --git a/src/vn/vncharacterconversation.h b/src/vn/vncharacterconversation.h
new file mode 100644
index 00000000..e96a986e
--- /dev/null
+++ b/src/vn/vncharacterconversation.h
@@ -0,0 +1,15 @@
+/**
+ * Copyright (c) 2021 Dominic Masters
+ * 
+ * This software is released under the MIT License.
+ * https://opensource.org/licenses/MIT
+ */
+
+#pragma once
+#include <dawn/dawn.h>
+#include "vncharacter.h"
+#include "vnconversation.h"
+
+vnconversationtext_t * vnCharacterConversationSetTalking(
+  vncharacter_t *character, vnconversation_t *conversation, bool talking
+);
\ No newline at end of file
diff --git a/src/vn/vnconversation.c b/src/vn/vnconversation.c
index 9e4e3137..6a17fec3 100644
--- a/src/vn/vnconversation.c
+++ b/src/vn/vnconversation.c
@@ -17,19 +17,31 @@ void vnConversationInit(vnconversation_t *convo, font_t *font) {
 
 void vnConversationNext(vnconversation_t *convo) {
   vnconversationtext_t *text;
+
+  // Fire onend for current text
+  if(convo->textCurrent != 0xFF) {
+    text = convo->texts + convo->textCurrent;
+    if(text->onEnd != NULL) text->onEnd(convo, text);
+  }
+
+  // Next Text
   convo->textCurrent++;
   if(convo->textCurrent >= convo->textCount) return;
   convo->delayStart = convo->timeline;
   text = convo->texts + convo->textCurrent;
 
-  if(text->text != NULL) {
-    vnTextBoxSetText(&convo->textbox, text->text);
-  }
+  
+  if(text->text != NULL) vnTextBoxSetText(&convo->textbox, text->text);
+  if(text->onStart != NULL) text->onStart(convo, text);
 }
 
 vnconversationtext_t * vnConversationAdd(vnconversation_t *conversation) {
   vnconversationtext_t *text = conversation->texts + conversation->textCount;
   conversation->textCount++;
+  text->data = NULL;
+  text->onStart = NULL;
+  text->onUpdate = NULL;
+  text->onEnd = NULL;
   text->text = NULL;
   return text;
 }
@@ -42,6 +54,8 @@ void vnConversationUpdate(vnconversation_t *convo, engine_t *engine) {
   if(convo->textCurrent >= convo->textCount) return;
 
   text = convo->texts + convo->textCurrent;
+  if(text->onUpdate) text->onUpdate(convo, text);
+
   if(text->text != NULL) {
     vnTextBoxUpdate(&convo->textbox, engine);
     if(convo->textbox.state & VN_TEXTBOX_STATE_CLOSED) {
@@ -59,5 +73,8 @@ void vnConversationRender(vnconversation_t *convo, shader_t *shader) {
 }
 
 void vnConversationDispose(vnconversation_t *convo) {
+  vnconversationtext_t *text;
+  text = convo->texts + convo->textCurrent;
+  if(text->onEnd != NULL) text->onEnd(convo, text);
   vnTextBoxDispose(&convo->textbox);
 }
\ No newline at end of file
diff --git a/src/vn/vnconversation.h b/src/vn/vnconversation.h
index d3920fa6..7bb94269 100644
--- a/src/vn/vnconversation.h
+++ b/src/vn/vnconversation.h
@@ -13,12 +13,19 @@
 
 /**
  * Initialize the conversation set. After adding your first conversation element
- * then ensure you call conversationNext to begin the first conversation piece.
+ * then ensure you call vnConversationNext to begin the conversation.
  * @param convo Conversation to initialize.
  * @param font Font to initialize with.
  */
 void vnConversationInit(vnconversation_t *convo, font_t *font);
 
+/**
+ * Goes to the next conversation element, or start the conversation if this is
+ * the first element.
+ * @param convo Conversation to skip to the next text of.
+ */
+void vnConversationNext(vnconversation_t *convo);
+
 /**
  * Add a text element to the conversation.
  * @param convo Conversation to add to.
@@ -26,6 +33,7 @@ void vnConversationInit(vnconversation_t *convo, font_t *font);
  */
 vnconversationtext_t * vnConversationAdd(vnconversation_t *convo);
 
+
 /**
  * Updates the conversation logic and the wrapped textbox.
  * @param convo Conversation to update.