Enhance BitmapFont and BitmapText Javadoc

[capdevon]

BitmapFont

• Adds comprehensive Javadoc comments to the BitmapFont class, explaining the purpose, usage, and parameters for public methods and constructors.
• Refactors import statements for clarity and explicitness.
• Improves class-level documentation to describe the font’s role, capabilities, and usage in the engine.
• Reorders and documents the rightToLeft property and associated getter/setter for better clarity.
• Enhances documentation for methods related to character set, font pages, and font styling.
• Updates and expands comments on text width calculation logic, including details on color tag parsing and kerning.
• Restores and documents the read and write (serialization) methods, moving them to the end of the class for organization.
• Improves code consistency and readability throughout the class for maintainability and developer onboarding.

BitmapText

• Adds detailed Javadoc comments to public methods and constructors in the BitmapText class.
• Clarifies the purpose, usage, and parameters of each method for improved API usability.
• Improves code readability and consistency with enhanced descriptions and minor cleanups.
• Helps new and existing users better understand and utilize BitmapText class features.

These updates aim to make the codebase more understandable for contributors and maintainers, while preserving all existing functionality.