src package

Subpackages

• src.core package
  • Submodules
  • src.core.memory module
    • Mario Kart DS (MKDS) Emulator I/O & Geometry Utilities
      • Quick Start
      • Key Concepts & Conventions
      • Public API Overview
      • Return Types & Shapes
      • Errors & Edge Cases
      • Performance Notes
      • Implementation Notes
      • Compatibility
    • frame_cache()
    • game_cache()
    • z_clip_mask()
    • read_clock_ptr()
    • read_clock()
    • get_current_course_id()
    • get_course_path()
    • load_current_kcl()
    • load_current_nkm()
    • read_racer_ptr()
    • read_position()
    • read_direction()
    • read_objects_array_max_count()
    • read_objects_array_ptr()
    • read_object_offset()
    • read_object_ptr()
    • read_object_flags()
    • read_object_position_ptr()
    • read_object_is_ignored()
    • read_object_is_deleted()
    • safe_object()
    • read_object_position()
    • read_map_object_type_id()
    • read_map_object_is_coin_collected()
    • read_racer_object_is_ghost()
    • read_objects()
    • read_camera_ptr()
    • read_camera_fov()
    • read_camera_aspect()
    • read_camera_position()
    • read_camera_target_position()
    • read_model_view()
    • project_to_screen()
    • read_checkpoint_ptr()
    • read_current_checkpoint()
    • read_current_key_checkpoint()
    • read_ghost_checkpoint()
    • read_ghost_key_checkpoint()
    • read_current_lap()
    • read_next_checkpoint()
    • read_previous_checkpoint()
    • read_checkpoint_positions()
    • read_next_checkpoint_position()
    • read_previous_checkpoint_position()
    • read_current_checkpoint_position()
    • read_facing_point_checkpoint()
    • read_forward_distance_checkpoint()
    • read_left_distance_checkpoint()
    • read_direction_to_checkpoint()
    • read_facing_point_obstacle()
    • read_closest_obstacle_point()
    • read_forward_distance_obstacle()
    • read_left_distance_obstacle()
    • read_right_distance_obstacle()
    • read_checkpoint_distance_altitude()
    • read_touching_prism_type()
    • read_mat_c()
    • read_pos_c()
    • read_driver_pos_c()
  • src.core.metric module
    • Metric
      • Metric.reset()
      • Metric.update()
      • Metric.collect()
    • DistanceMetric
      • DistanceMetric.reset()
      • DistanceMetric.update()
      • DistanceMetric.collect()
    • SpeedMetric
      • SpeedMetric.reset()
      • SpeedMetric.update()
      • SpeedMetric.collect()
    • OffroadMetric
      • OffroadMetric.reset()
      • OffroadMetric.update()
      • OffroadMetric.collect()
    • collect_all()
    • reset_all()
    • FitnessScorer
    • default_fitness_scorer()
  • src.core.model module
    • NodeGene
    • ConnGene
    • Genome
      • Genome.mutate_weight()
      • Genome.mutate_add_conn()
      • Genome.mutate_add_node()
    • EvolvedNet
      • EvolvedNet.forward()
    • JSONEncoder
      • JSONEncoder.default()
    • load_genome()
    • save_genome()
  • src.core.train module
    • Key concepts
    • Threading & processes
    • Shared-memory lifetime
    • EmulatorProcessConfig
      • EmulatorProcessConfig.id
      • EmulatorProcessConfig.sample
      • EmulatorProcessConfig.host
      • EmulatorProcessConfig.show
    • EmulatorBatchConfig
      • EmulatorBatchConfig.size
      • EmulatorBatchConfig.display_shm_names
      • EmulatorBatchConfig.device
      • EmulatorBatchConfig.overlay_ids
      • EmulatorBatchConfig.metric_factories
    • CheckpointRecord
      • CheckpointRecord.id
      • CheckpointRecord.times
      • CheckpointRecord.dists
    • safe_shared_memory()
    • initialize_emulator()
    • initialize_window()
    • initialize_overlays()
    • handle_controls()
    • initialize_model()
    • safe_thread()
    • send_window_end_signal()
    • get_forward_func()
    • run_training_batch()
    • run_training_session()
    • fitness()
    • train()
    • make_distance_metric()
    • main()
  • Module contents
• src.mkds_extensions package
  • Submodules
  • src.mkds_extensions.kcl_torch module
    • PrismsTensor
      • PrismsTensor._height
      • PrismsTensor._pos_i
      • PrismsTensor._fnrm_i
      • PrismsTensor._enrm1_i
      • PrismsTensor._enrm2_i
      • PrismsTensor._enrm3_i
      • PrismsTensor._attributes
      • PrismsTensor.map_2d_shadow
      • PrismsTensor.light_id
      • PrismsTensor.ignore_drivers
      • PrismsTensor.collision_variant
      • PrismsTensor.collision_type
      • PrismsTensor.ignore_items
      • PrismsTensor.is_wall
      • PrismsTensor.is_floor
    • KCLTensor
      • KCLTensor._positions_offset
      • KCLTensor._normals_offset
      • KCLTensor._prisms_offset
      • KCLTensor._block_data_offset
      • KCLTensor._prism_thickness
      • KCLTensor._area_min_pos
      • KCLTensor._area_x_width_mask
      • KCLTensor._area_y_width_mask
      • KCLTensor._area_z_width_mask
      • KCLTensor._block_width_shift
      • KCLTensor._area_x_blocks_shift
      • KCLTensor._area_xy_blocks_shift
      • KCLTensor._sphere_radius
      • KCLTensor._prisms
      • KCLTensor._positions
      • KCLTensor._normals
      • KCLTensor.prism_cls
      • KCLTensor.search_triangles()
      • KCLTensor.nearest_triangles()
      • KCLTensor.from_file()
  • src.mkds_extensions.nkm_torch module
    • CPOITensor
    • NKMTensor
  • Module contents
• src.utils package
  • Submodules
  • src.utils.vector module
    • get_mps_device()
    • cross_product_2d()
    • triangle_raycast()
    • intersect_ray_line_2d()
    • triangle_raycast_batch()
    • pairwise_distances()
    • pairwise_distances_cross()
    • compute_orthonormal_basis()
    • compute_model_view()
    • project_to_screen()
    • sample_cone()
    • sample_semicircular_sweep()
    • clipped_mean()
    • interpolate()
    • smooth_mean()
    • project()
    • extrapolate()
    • triangle_altitude()
  • Module contents
• src.visualization package
  • Submodules
  • src.visualization.draw module
    • draw_stack_op()
    • draw_points()
    • draw_lines()
    • draw_triangles()
    • draw_text()
    • draw_paragraph()
    • consume_draw_stack()
  • src.visualization.overlay module
    • register_overlay()
    • collision_overlay()
    • raycasting_overlay()
    • camera_overlay()
    • checkpoint_overlay_1()
    • checkpoint_overlay_2()
    • player_overlay()
  • src.visualization.window module
    • start_keyboard_listener()
    • on_draw_memoryview()
    • apply_overlay_to_surface()
    • SharedEmulatorWindow
      • SharedEmulatorWindow.on_draw()
      • SharedEmulatorWindow.refresh()
    • EmulatorWindow
      • EmulatorWindow.start()
      • EmulatorWindow.kill()
    • on_draw_main()
    • on_configure_main()
  • Module contents

Submodules

src.main module

src.main.start_keyboard_listener()

Starts a non-blocking keyboard listener in a separate thread.

src.main.on_draw_main(widget: gi.repository.Gtk.DrawingArea, ctx: cairo.Context)

src.main.on_configure_main(widget: gi.repository.Gtk.DrawingArea, *args)

class src.main.EmulatorWindow(*args: Any, **kwargs: Any)

Bases: Window

src.main.worker()

src.main.run_emulator(overlays)

Module contents