JustWeTools

ReadView

ReadView is a Canvas-based novel reader that supports customization of fonts, font sizes, and text colors.

Usage

Initialize the view by passing the context and the directory path of the file to be read:

ReadView readView = new ReadView(this, dir.getPath());
setContentView(readView);

To use JustWeTools in an Android project using Gradle, follow these two steps:

1. Add the JitPack repository to your root build.gradle file inside the allprojects block.
2. Add the dependency to your module-level build.gradle file.

// Step 1: Add JitPack to root build.gradle
allprojects {
    repositories {
        ... 
        maven { url "https://jitpack.io" }
    }
}

// Step 2: Add dependency to module build.gradle
dependencies {
    compile 'com.github.lfkdsk:JustWeTools:v1.0'
}

MarkDownView

MarkDownView is a WebView-based renderer that supports standard Markdown syntax. Its API is designed to be consistent with CodeView.

Setup

1. Add the view to your XML layout:

<com.lfk.justwetools.View.MarkDown.MarkDownView
    android:id="@+id/markdownview"
    android:layout_width="match_parent"
    android:layout_height="match_parent"/>

2. Provide content via a String or a Directory:

• Via String: markDownView.setStringSource(String content)
• Via Directory: markDownView.setDirSource(File dir)

To use JustWeTools in a Maven-based project, add the JitPack repository and then the specific dependency to your pom.xml.

<!-- Step 1: Add JitPack repository -->
<repositories>
    <repository>
        <id>jitpack.io</id>
        <url>https://jitpack.io</url>
    </repository>
</repositories>

<!-- Step 2: Add dependency -->
<dependency>
    <groupId>com.github.lfkdsk</groupId>
    <artifactId>JustWeTools</artifactId>
    <version>v1.0</version>
</dependency>

ProportionView

ProportionView provides a visual analysis of file type ratios within a directory. It is best used in conjunction with ExplorerView.

Setup

1. Add the view to your XML layout:

<com.lfk.justwetools.View.Proportionview.ProportionView
    android:id="@+id/pv"
    android:layout_margin="10dp"
    android:layout_width="match_parent"
    android:layout_height="30dp" />

2. Update the data whenever the file explorer path changes:

fileExplorer.setOnPathChangedListener(new OnPathChangedListener() {
    @Override
    public void onPathChanged(String path) {
        try {
            view.setData(fileExplorer.getPropotionText(path));
        } catch (Exception e) {
            // Handle error (e.g., path inaccessible)
        }
    }
});

VerTextView

VerTextView is a specialized TextView for vertical text layout. It includes built-in support for customizable underlines.

Setup

1. Add the view to your XML layout:

<com.lfk.justwetools.View.VerText.VerTextView
    android:id="@+id/vertextview"
    android:layout_width="wrap_content"
    android:layout_height="wrap_content" />

2. Configure properties:

• setFontSize(int size): Set font size.
• setIsOpenUnderLine(boolean): Enable/disable underlines.
• setUnderLineColor(int color): Set underline color.
• setUnderLineWidth(int width): Set underline thickness.
• setUnderLineSpacing(int spacing): Set spacing between text and underline.
• setTextStartAlign(int align): Set alignment (e.g., VerTextView.RIGHT or VerTextView.LEFT).
• setTextColor(int color): Set text color.

CodeView

CodeView is a WebView-based code editor that supports syntax highlighting, dark themes, and real-time editing.

Basic Setup

1. Add the view to your XML layout:

<com.lfk.justwetools.View.CodeView.CodeView
    android:id="@+id/mcodeview"
    android:layerType="hardware"
    android:layout_width="match_parent"
    android:layout_height="match_parent"/>

2. Set the source directory in your Activity:

codeView = (CodeView)findViewById(R.id.mcodeview);
File dir = new File(fileUri.getPath());
if (dir != null) {
    codeView.setDirSource(dir);
}

Enabling Editing

To toggle editing mode, use setContentEditable(boolean):

if (!codeView.isEditable()) {
    codeView.setContentEditable(true);
} else {
    codeView.setContentEditable(false);
}

Note: If manually copying code, ensure you include the JS files from the assets folder.

Clock

Clock is a custom View that draws a clock face.

Setup

1. Add the view to your XML layout:

<com.lfk.justwetools.View.Clock.Clock
    android:id="@+id/clock"
    android:layout_width="match_parent"
    android:layout_height="wrap_content" />

Configuration Methods

• setColor(int color): Set clock color.
• setNeedleColor(int needleColor): Set needle color.
• setTextColor(int textColor): Set text color.
• setCircleColor(int circleColor): Set circle color.
• setUnthehourLineColor(int color): Set color for non-hour lines.
• setThehourLineColor(int color): Set color for hour lines.
• setHourSize(int hourSize): Set size for hour markers.

PaintView is a custom Android View component designed for drawing and erasing on a canvas. It supports setting brush colors, pen widths, and eraser widths. It also provides functionality to load background images via Uri and save the drawing as a JPEG file.

// Example initialization in an Activity or Fragment
PaintView paintView = new PaintView(context);
// Set up a listener to record paths
paintView.setOnPathListener(myPathListener);
// Add to your layout
layout.addView(paintView);

To record user strokes for later playback or serialization, implement the OnPathListener interface and register it with setOnPathListener.

When setIsRecordPath(boolean isRecordPath) is enabled, the view will call addNodeToPath on every touch event (DOWN, MOVE, UP). This allows you to capture the full sequence of coordinates, colors, and widths used during a drawing session.