power-play/FtcRobotController/src/main/java/org/firstinspires/ftc/robotcontroller/external/samples

Caution

No Team-specific code should be placed or modified in this .../samples folder.

Samples should be Copied from here, and then Pasted into the team's /TeamCode/src/main/java/org/firstinspires/ftc/teamcode folder, using the Android Studio cut and paste commands. This automatically changes all file and class names to be consistent. From there, the sample can be modified to suit the team's needs.

For more detailed instructions see the /teamcode readme.

Naming of Samples

To gain a better understanding of how the samples are organized, and how to interpret the naming system, it will help to understand the conventions that were used during their creation.

These conventions are described (in detail) in the sample_conventions.md file in this folder.

To summarize: A range of different samples classes will reside in the java/external/samples. The class names will follow a naming convention which indicates the purpose of each class. The prefix of the name will be one of the following:

Basic: This is a minimally functional OpMode used to illustrate the skeleton/structure of a particular style of OpMode. These are bare bones examples.

Sensor: This is a Sample OpMode that shows how to use a specific sensor. It is not intended to drive a functioning robot, it is simply showing the minimal code required to read and display the sensor values.

Robot: This is a Sample OpMode that assumes a simple two-motor (differential) drive base. It may be used to provide a common baseline driving OpMode, or to demonstrate how a particular sensor or concept can be used to navigate.

Concept: This is a sample OpMode that illustrates performing a specific function or concept. These may be complex, but their operation should be explained clearly in the comments, or the comments should reference an external doc, guide or tutorial. Each OpMode should try to only demonstrate a single concept so they are easy to locate based on their name. These OpModes may not produce a drivable robot.

After the prefix, other conventions will apply:

• Sensor class names are constructed as: Sensor - Company - Type
• Robot class names are constructed as: Robot - Mode - Action - OpModetype
• Concept class names are constructed as: Concept - Topic - OpModetype